home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Sound / Tracker / PTSUP2.LHA / PT Support archive / ProTracker.txt < prev    next >
Encoding:
Text File  |  1995-11-01  |  172.2 KB  |  5,617 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                 Default
  7.  
  8.  
  9.                                 Version
  10.                                   N.A.
  11.  
  12.  
  13.  
  14.  
  15.                             Håvard Pedersen
  16.  
  17.  
  18.  
  19.                        © 1994-95 Mental Diseases
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.                       Generated with Heddley v1.1
  37.                    Heddley v1.1 (C) Edd Dumbill 1994
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.                                - Page 1 -
  77.  
  78.  
  79.  
  80. 1.    ProTracker documentation
  81.  
  82.  
  83.     ProTracker V3.x - The AmigaGuide documentation
  84.  
  85.  
  86.     "...The use of noise to make music will continue and increase until
  87.     we reach a music produced through the aid of electrical
  88.     instruments, which will make available for musical purposes any and
  89.     all sounds that can be heard."
  90.                     -- John Cage
  91.  
  92.     "It is not hard to compose, but it is wonderfully hard to let the
  93.     superfluous notes fall under the table."
  94.                     -- Johannes Brahms
  95.  
  96.  
  97.     Table of contents:
  98.  
  99.     Introduction
  100.     Gadgets
  101.     Nice to know
  102.     How to create music using ProTracker
  103.     Miscellaneous
  104.     For the technical minded
  105.  
  106.  
  107. Powerpacker.library is © Nico François and req.library is © Bruce Dawson
  108. and Colin Fox.
  109.  
  110. This AmigaGuide® help-file is based on the printable help-file for
  111. ProTracker V1.3 by Lars Hamre, and is made by Håvard "HOWARD/MENTAL
  112. DISEASES" Pedersen. DYN technical chapter by PUW.
  113.  
  114. More specific credits are found in both the 'version history' and the
  115. 'contact the authors' chapters.
  116.  
  117. Consider this entire documentation a beta. If there's anything missing,
  118. please inform us.
  119.  
  120. 2.    Introduction
  121.  
  122. This chapter contains basic information about ProTracker and how and why
  123. to get started using it.
  124.  
  125.         What is ProTracker?
  126.         Legal mush
  127.         How to start ProTracker
  128.  
  129. 3.    What is ProTracker?
  130.  
  131. ProTracker is a so-called "Tracker", a program designed for creating
  132. music savable as a MOD-file. The most significant difference between
  133. ProTracker and other trackers are that ProTracker is based on the
  134. original tracker, SoundTracker. It has also more built-in tools than
  135. almost any other tracker and supports all aspects of the MOD
  136. file-format. (With the exception of 100-pattern modules)
  137.  
  138. If you doesn't count MIDI, about 98% of all music on the Amiga is made
  139. on ProTracker. The ProTracker has become a standard for music and the
  140. MOD-files are even supported by most sample-based music programs on the
  141. PC. (I've even seen some players for Macintosh that supported them!)
  142.  
  143. We must admit that the user-interface for the ProTracker is neither
  144. multitasking-friendly nor does it conform to the standard GUI
  145. guidelines. The reason for this is that the GUI consumes quite a bit of
  146.  
  147.                                - Page 2 -
  148. 3.    What is ProTracker?
  149.  
  150. the program itself, and it would be a very time-consuming job to port it
  151. to use the system. (Besides, not all keyboard-shortcuts are comfortably
  152. read through the system.)
  153.  
  154. 4.    Legal mush
  155.  
  156. All users and distributors must read this!
  157.  
  158. - This program is fully public domain software, and may therefore
  159. freely be copied by anyone to anyone.
  160.  
  161. - The authors will not accept any charges demanded for
  162. distribution and/or copying of this program which exceeds the nominal
  163. charge for postage, handling and disks.
  164.  
  165. - The authors takes no responsibility for any damages caused by use
  166. or misuse of this program, though all efforts are taken to make it as
  167. faultless as possible.
  168.  
  169. - This program is law-established intellectual achievement, and
  170. is therefore regulated by laws concerning such, where such laws exists.
  171.  
  172. - By using and/or distributing this program, you indicate your
  173. agreement with these paragraphs.
  174.  
  175. - If there are any of these paragraphs you do not understand, you
  176. are obliged to contact the authors and ask for further information
  177. before indicating your agreement through the previous paragraph.
  178.  
  179. - Any violation of these paragraphs is both illegal and immoral.
  180.  
  181. 5.    How to start ProTracker
  182.  
  183. ProTracker may be started from both CLI and Workbench. (Type name in CLI
  184. or doubleclick on icon from Workbench)
  185.  
  186. No arguments or tooltypes are supported yet, though.
  187.  
  188. 6.    Gadgets
  189.  
  190. This chapter should explain all gadgets and gizmos in ProTracker.
  191.  
  192.  
  193.         Mainscreen
  194.  
  195.         Various
  196.         Song section
  197.         Sample section
  198.         Edit options
  199.         Sample edit
  200.         Chord editor
  201.         Filter editor
  202.         Edit gadgets
  203.  
  204.  
  205.         Setup
  206.  
  207.         Miscellaneous
  208.         Flags
  209.  
  210.  
  211.         Disk operations
  212.  
  213.         Disk operations
  214.  
  215.  
  216.         Sampler
  217.  
  218.                                - Page 3 -
  219. 6.    Gadgets
  220.  
  221.  
  222.         Main
  223.         Volume requester
  224.  
  225. 7.    Main screen - Various
  226.  
  227. CLOSEGADGET
  228.  
  229. This is a small box located in the upper left corner of the ProTracker
  230. screen. Pressing this will quit.
  231.  
  232.  
  233.  
  234. QUADRASCOPE
  235.  
  236. This is 4 "boxes" located in the upper right part of your screen. These
  237. shows the waveform currently being played on each channel. Clicking in
  238. any of these will disable the respective channel and ghost the box.
  239.  
  240.  
  241.  
  242. DEPTHGADGET
  243.  
  244. This is another box located in the upper right corner of the ProTracker
  245. screen. Pressing this will push the ProTracker screen behind all other
  246. screens currently open.
  247.  
  248.  
  249.  
  250. DATE
  251.  
  252. Shows the current date. (Atleast your computers idea of it!)
  253.  
  254.  
  255.  
  256. TIME
  257.  
  258. Shows the system time.
  259.  
  260.  
  261.  
  262. PLAY
  263.  
  264. Shows the time elapsed since ProTracker started playing.
  265.  
  266.  
  267.  
  268. EDIT OPTIONS (Numbers 1 - 7)
  269.  
  270. The edit options represent several small "tools" grouped into (somewhat)
  271. clear categories. The upper line will state what these functions will
  272. affect. The numbers are:
  273.  
  274.     1 - Edit options
  275.     2 - Sample edit
  276.     3 - Chord editor
  277.     4 - Filter editor
  278.  
  279.  
  280.  
  281. STATUS
  282.  
  283. Shows a somewhat descriptive text describing what ProTracker is doing.
  284.  
  285.  
  286.  
  287. CHIP
  288.  
  289.                                - Page 4 -
  290. 7.    Main screen - Various
  291.  
  292.  
  293. Shows how much chip-memory there is left on your Amiga.
  294.  
  295.  
  296.  
  297. FAST
  298.  
  299. Shows how much fast-memory there is left on your Amiga.
  300.  
  301.  
  302.  
  303. TUNE
  304.  
  305. Shows how much memory the current module uses.
  306.  
  307.  
  308.  
  309. PUBL
  310.  
  311. Shows how much memory (any type) there is left on your Amiga.
  312.  
  313.  
  314.  
  315. PATTERNNUMBER GADGET
  316.  
  317. This is a small box to the left of the BPM gadget, and represents the
  318. number of the pattern currently being edited. Click on it to type in a
  319. new number.
  320.  
  321.  
  322.  
  323. BPM
  324.  
  325. The tempo gadget on the status bar is for setting the CIA speed, if CIA
  326. timing is used. The gadget will be updated every time you set the speed
  327. using the F command (if CIA that is). This gadget does not show actual
  328. beats per minute unless the speed is 6!
  329.  
  330.  
  331.  
  332. The main screen has some indicators on the left side of the statustext.
  333. The indicators are as follows:
  334.  
  335. M S M (Metronome ON, Split keyboard ON, Multi keyboard ON) I 0-9
  336. (AutoInsert ON, AutoInsert Macro)
  337.  
  338. 8.    Main screen - Song section
  339.  
  340. SONGNAME
  341.  
  342. This defines the name of your module.
  343.  
  344.  
  345.  
  346. MASTERVOLUME
  347.  
  348. Defines the volume of your module. This gadget affects playing only, and
  349. the setting is not saved along with your module in current version of
  350. ProTracker.
  351.  
  352.  
  353.  
  354. POS
  355.  
  356. Defines the current position in the position-table.
  357.  
  358.  
  359.  
  360.                                - Page 5 -
  361. 8.    Main screen - Song section
  362.  
  363.  
  364. I(NSERT)
  365.  
  366. Insert a position into your song.
  367.  
  368.  
  369.  
  370. D(ELETE)
  371.  
  372. Delete a position from your song.
  373.  
  374.  
  375.  
  376. PATTERN
  377.  
  378. Defines which pattern will be played at the selected position.
  379.  
  380.  
  381.  
  382. LENGTH (SONG)
  383.  
  384. Defines the length of the song.
  385.  
  386.  
  387.  
  388. PLAY
  389.  
  390. Will play the song from the current position in the song. The pointer
  391. turns yellow, just to show you what's going on.
  392.  
  393.  
  394.  
  395. PATTERN
  396.  
  397. Will play the current pattern which is shown at the bottom of the
  398. screen. The pointer turns yellow here as well. Holding down the right
  399. button while pressing play,pattern or record will play from the current
  400. patternposition.
  401.  
  402.  
  403.  
  404. CLEAR
  405.  
  406. Will first ask you what you want to clear. You can clear either all,
  407. song or samples. In addition to the gadgets you can use "A" for All, "O"
  408. for Song, "S" for samples and "C" or ESC for Cancel.
  409.  
  410.  
  411.  
  412. STOP
  413.  
  414. Will stop playing of songs and patterns, recording, and will turn edit
  415. mode off.
  416.  
  417.  
  418.  
  419. RECORD
  420.  
  421. Will put you in edit mode, but also play the current pattern or song.
  422. You can select this in the Edit Options menu. While the pattern or song
  423. is playing, you can type in notes and numbers from the keyboard, and
  424. they will appear in the pattern as it scrolls. The notes and numbers
  425. will also be quantized to the nearest slot, so that keeping a steady
  426. rhythm is no problem. The pointer will turn blue here as well as in the
  427. the normal edit mode.
  428.  
  429.  
  430.  
  431.                                - Page 6 -
  432. 8.    Main screen - Song section
  433.  
  434.  
  435. SETUP
  436.  
  437. Will go to the Setup Screen.
  438.  
  439.  
  440.  
  441. CONTINUE
  442.  
  443. Will continue the module from the last stopped position.
  444.  
  445.  
  446.  
  447. EDIT
  448.  
  449. Will put you in edit mode. The pointer turns blue, and you can enter
  450. notes and numbers from the keyboard. Use the arrowkeys to move up/down
  451. and left/right in the pattern. Entering a note or a number will cause
  452. the pattern to jump one or more slots down.
  453.  
  454.  
  455.  
  456. DISK OP.
  457.  
  458. Will go to the Disk operation screen.
  459.  
  460. 9.    Main screen - Sample section
  461.  
  462. SAMPLENAME
  463.  
  464. This defines the name of the current sample.
  465.  
  466.  
  467.  
  468. SAMPLE
  469.  
  470. The number of the chosen sample. You can have up to 31, or hex $1F
  471. samples in a song. Pressing both mousebuttons at the same time will set
  472. the samplenumber to zero. You can then record the pattern with sample 0
  473. to prevent ProTracker from setting the volume each time you play a new
  474. note.
  475.  
  476.  
  477.  
  478. VOLUME
  479.  
  480. Use this to set the volume the current sample will be played with.
  481.  
  482.  
  483.  
  484. FINETUNE
  485.  
  486. Tune your untuned samples to match the others.
  487.  
  488.     0 436.4 hz    -1 432.1 hz
  489.     1 439.0 hz    -2 429.6 hz
  490.     2 441.6 hz    -3 426.3 hz
  491.     3 445.1 hz    -4 423.1 hz
  492.     4 447.8 hz    -5 419.9 hz
  493.     5 451.5 hz    -6 416.7 hz
  494.     6 455.2 hz    -7 414.4 hz
  495.     7 457.0 hz    -8 412.0 hz
  496.  
  497. To experienced musicians, this table clearly will seem wrong. A normal
  498. tuning should be 440! The reason to this is that ProTracker uses NTSC
  499. periods for playback.
  500.  
  501.  
  502.                                - Page 7 -
  503. 9.    Main screen - Sample section
  504.  
  505.  
  506.  
  507. LENGTH (SAMPLE)
  508.  
  509. The Length gadgets are simply used for setting the length of the sample.
  510. A sample can be up to 64k, or $fffe long. You can add workspace behind
  511. the sample by increasing the length and letting go of the button.
  512. ProTracker will ask if you are sure, and if you are, allocate more
  513. memory for the sample.
  514.  
  515.  
  516.  
  517. REPEAT
  518.  
  519. Here you set the start of the sampleloop.
  520.  
  521.  
  522.  
  523. REPLEN
  524.  
  525. Here you set the length of the sampleloop.
  526.  
  527.  
  528.  
  529. LOAD SAMPLE
  530.  
  531. Will simply try to load the current samplename. Use this when you've
  532. fucked up in the sample editor, and have destroyed a sample.
  533.  
  534.  
  535.  
  536. KILL SAMPLE
  537.  
  538. Will remove the current sample from your module.
  539.  
  540.  
  541.  
  542. SAMPLER
  543.  
  544. Will go to the Sampler screen.
  545.  
  546. 10.    Main screen - Edit options
  547.  
  548. QUANTIZE
  549.  
  550. Will move the notes you record to every n'th slot. Entering 00 will turn
  551. off the quantizing, and the notes you play will always be inserted at
  552. the patternposition you are at. Entering 01 will quantize the notes the
  553. the nearest slot according to the speed. i.e. if you play a note after
  554. the first half has been played, it will be quantized to the slot below.
  555. Entering a value like 8 will quantize to every 8th note, and so on. Got
  556. that?
  557.  
  558.  
  559.  
  560. METROSAMP
  561.  
  562. [This option is not currently implemented, nor documented!]
  563.  
  564.  
  565.  
  566. METRONOME
  567.  
  568. A metronome is a steady sound which helps you keep the speed when
  569. recording. (I'm not particulary good at explaining, try it out!)
  570.  
  571. The first number is the speed of the metronome, and the second is the
  572.  
  573.                                - Page 8 -
  574. 10.    Main screen - Edit options
  575.  
  576. channel to play it on. The Sample used for metronomes is always sample
  577. $1F. Load your own favourite metronome sample. The metronome will always
  578. be played at C-3, but you can still change the volume and loop values.
  579. To turn off the metronome, just set the speed or channel to 0.
  580.  
  581.  
  582.  
  583. MULTI
  584.  
  585. This table is used with the multi keyboard option. The four numbers
  586. represent what channel each channel will jump to next. 1-2, 2-3, 3-4 and
  587. so on.
  588.  
  589.  
  590.  
  591. RECORD HOLD
  592.  
  593. When this is set to "on", record will not start until the first
  594. keypress.
  595.  
  596.  
  597.  
  598. SAMPLE
  599.  
  600. This selects wether the edit buttons should affect all samples, or the
  601. current samples only.
  602.  
  603.  
  604.  
  605. RECORD
  606.  
  607. This selects wether the record function should record a pattern, or the
  608. entire song.
  609.  
  610.  
  611.  
  612. PLAYNOTE
  613.  
  614. When set to "multi", ProTracker will jump to another channel after you
  615. play a note on the keyboard. This makes it possible to play two or more
  616. notes at the same time (very useful with midi).
  617.  
  618.  
  619.  
  620. EDIT
  621.  
  622. This selects wether ProTracker should go right when inserting notes, or
  623. down to the next step.
  624.  
  625. 11.    Main screen - Sample edit
  626.  
  627. To the left of the title bar is a box which states what should be
  628. affected by the copy, exchange and delete gadgets. (Current track, whole
  629. pattern, real samples.)
  630.  
  631. To the right of the title bar is a box which states the mixingmode.
  632. "half" will halve the volume when mixing and echoing to avoid clipping,
  633. while "clip" will not halve the volume and possibly clip the sample.
  634.  
  635.  
  636.  
  637. DELETE
  638.  
  639. Will delete all notes with the current sample in current track or whole
  640. pattern.
  641.  
  642.  
  643.  
  644.                                - Page 9 -
  645. 11.    Main screen - Sample edit
  646.  
  647.  
  648. KILL
  649.  
  650. Will kill the current sample. That is, remove it from memory and reset
  651. all sample settings. It will not be deleted from the track or pattern.
  652.  
  653.  
  654.  
  655. EXCHANGE
  656.  
  657. Will exchange the samplenumber shown in the "from" gadget with the
  658. samplenumber in the "to" gadget and vice versa.
  659.  
  660.  
  661.  
  662. COPY
  663.  
  664. Will move the samplenumber shown in the "from" gadget to the sample-
  665. number in the "to" gadget.
  666.  
  667.  
  668.  
  669. MIX
  670.  
  671. Will mix one sample with another. ProTracker asks you which two samples
  672. to be mixed, and where to put the result.
  673.  
  674. Holding the right button and pressing mix will mix the current sample
  675. with itself. You can offset the sample by setting a position in the
  676. "pos" gadget If you set "mod" to a non-zero value, the sample will also
  677. be modulated.
  678.  
  679.  
  680.  
  681. ECHO
  682.  
  683. Will create a echo effect on the current sample. Use "pos" to set the
  684. delay time of the echo. If you want more room to echo in, just turn up
  685. the length of the sample.
  686.  
  687.  
  688.  
  689. BOOST
  690.  
  691. Will turn up the treble of the sample. Use this on hi-hats and snares!
  692. If the sampler screen is open and a range is selected, this will only
  693. affect the selected range.
  694.  
  695.  
  696.  
  697. FILTER
  698.  
  699. Will Delta-filter the sample. Use this on noisy basses. If the sampler
  700. screen is open and a range is selected, this will only affect the
  701. selected range.
  702.  
  703.  
  704.  
  705. X-FADE
  706.  
  707. Will crossfade the sample (mix with itself, backwards). Handy for
  708. looping samples that are hard to loop.
  709.  
  710.  
  711.  
  712. BACKWD (Backwards)
  713.  
  714.  
  715.                               - Page 10 -
  716. 11.    Main screen - Sample edit
  717.  
  718. Will turn the sample backwards!
  719.  
  720.  
  721.  
  722. UPSAMPLE
  723.  
  724. Will remove every second byte of the sample, halving the length and
  725. shifting the pitch one octave up.
  726.  
  727.  
  728.  
  729. DOWNSAMPLE
  730.  
  731. Will double every byte of the sample, doubling the length, and shifting
  732. the pitch one octave down.
  733.  
  734.  
  735.  
  736. POS
  737.  
  738. This is just an offset in the sample, used for a lot of things.This one
  739. has a numbergadget as well. Holding the right mousebutton while pressing
  740. the numbergadget will zero the value.
  741.  
  742.  
  743.  
  744. MOD
  745.  
  746. This is used for modulation. Press "mod" to modulate the current sample.
  747. Holding the right button while pressing the numbergadget will zero the
  748. value.
  749.  
  750.  
  751.  
  752. CUTBEG(INNING)
  753.  
  754. Will chop the number of bytes set in the "pos" gadget off the beginning
  755. of the sample.
  756.  
  757.  
  758.  
  759. FU (Fade Up)
  760.  
  761. Will fade the volume from 0 to 100%. Use "pos" to select where in the
  762. sample to fade up to. If the sampler screen is open and a range is
  763. selected, this will only affect the selected range.
  764.  
  765.  
  766.  
  767. FD (Fade Down)
  768.  
  769. Will fade the volume from 100 to 0%. Use "pos" to select where in the
  770. sample to fade down from. If the sampler screen is open and a range is
  771. selected, this will only affect the selected range.
  772.  
  773.  
  774.  
  775. VOL
  776.  
  777. With this you can change the "real" volume of the sample. Just set a
  778. percentage and press "vol". vol has a numbergadget. Holding the right
  779. button while pressing it will set the value to 100%. If the sampler
  780. screen is open and a range is selected, this will only affect the
  781. selected range.
  782.  
  783. You may also set "POS" by clicking on the sample and setting the
  784. cursor-line.
  785.  
  786.                               - Page 11 -
  787. 11.    Main screen - Sample edit
  788.  
  789.  
  790. 12.    Main screen - Chord editor
  791.  
  792. FROM SAMPLE
  793.  
  794. Selects which sample to mix the chords from. Clicking on it sets the
  795. current sample.
  796.  
  797.  
  798.  
  799. TO SAMPLE
  800.  
  801. Selects which sample to put the chord into. Clicking on it sets the
  802. current sample.
  803.  
  804.  
  805.  
  806. NOTES
  807.  
  808. Sets how many notes your chord contains.
  809.  
  810.  
  811.  
  812. ADJUST
  813.  
  814. [Sorry, not enough info for documentation...]
  815.  
  816.  
  817.  
  818. MAKE CHORD
  819.  
  820. Does the work.
  821.  
  822.  
  823.  
  824. NOTE 1 - NOTE 7
  825.  
  826. The notes to use in the chord. Click in gadgets to edit.
  827.  
  828. 13.    Main screen - Filter editor
  829.  
  830. [No documentation exists on the filter editor, but I couldn't get it to
  831. do anything!]
  832.  
  833. 14.    Main screen - Edit gadgets
  834.  
  835. TRACK/PATT/CMDS/BLOCK
  836.  
  837. Selects what to be affected by the edit gadgets. (Refered to as range.)
  838.  
  839.  
  840.  
  841. INSERT
  842.  
  843. Inserts the buffer at current position.
  844.  
  845.  
  846.  
  847. CUT
  848.  
  849. Deletes the range and moves it to the buffer.
  850.  
  851.  
  852.  
  853. DELETE
  854.  
  855. Deletes the current step and moves all preceding one step up. (Not
  856.  
  857.                               - Page 12 -
  858. 14.    Main screen - Edit gadgets
  859.  
  860. block)
  861.  
  862.  
  863.  
  864. COPY
  865.  
  866. Copies the range to the buffer.
  867.  
  868.  
  869.  
  870. CLEAR
  871.  
  872. Deletes the range. (Not block)
  873.  
  874.  
  875.  
  876. PASTE
  877.  
  878. Pastes the buffer out to current position.
  879.  
  880.  
  881.  
  882. FLIP
  883.  
  884. Turns the range backwards.
  885.  
  886.  
  887.  
  888. EXCHANGE
  889.  
  890. Exchange range with buffer.
  891.  
  892.  
  893.  
  894. OCTAVE UP
  895.  
  896. Transposes range one octave up.
  897.  
  898.  
  899.  
  900. OCTAVE DOWN
  901.  
  902. Transposes range one octave down.
  903.  
  904.  
  905.  
  906. NOTE UP
  907.  
  908. Transposes range one note up.
  909.  
  910.  
  911.  
  912. NOTE DOWN
  913.  
  914. Transposes range one note down.
  915.  
  916.  
  917.  
  918. SCROLL UP
  919.  
  920. Scrolls range one step up.
  921.  
  922.  
  923.  
  924. SCROLL DOWN
  925.  
  926. Scrolls range one step down.
  927.  
  928.                               - Page 13 -
  929. 14.    Main screen - Edit gadgets
  930.  
  931.  
  932.  
  933.  
  934. ROTATE UP
  935.  
  936. Same as scroll, but inserts note scrolled out at top at bottom step.
  937.  
  938.  
  939.  
  940. ROTATE DOWN
  941.  
  942. Same as scroll, but inserts note scrolled out at bottom at top step.
  943.  
  944. 15.    Setup screen - Miscellaneous
  945.  
  946. MAIN MENU
  947.  
  948. Will exit the setup screen, and return to the main screen.
  949.  
  950.  
  951.  
  952. LOAD CONFIG
  953.  
  954. Will load the selected config file.
  955.  
  956.  
  957.  
  958. SAVE CONFIG
  959.  
  960. Will save the selected config file.
  961.  
  962.  
  963.  
  964. CFG
  965.  
  966. Selects the current configuration to use.
  967.  
  968.  
  969.  
  970. RESET ALL
  971.  
  972. Will reset to the original ProTracker configuration.
  973.  
  974.  
  975.  
  976. THE COLOR PALETTE
  977.  
  978. The color palette is simple to use. Just select a color, and use the R,
  979. G and B sliders to set the color. You may also edit the colors for the
  980. VU-meters by pressing anywhere within the VU-cols and edit.
  981.  
  982.  
  983.  
  984. COPY
  985.  
  986. Copies a color. Select the color to copy, select "copy", select
  987. destination color.
  988.  
  989.  
  990.  
  991. SPREAD
  992.  
  993. For use with the VU-meter colors. Press at start color, select "spread",
  994. and select destination color to make ProTracker calculate a nice fade
  995. between the two colors.
  996.  
  997.  
  998.  
  999.                               - Page 14 -
  1000. 15.    Setup screen - Miscellaneous
  1001.  
  1002.  
  1003. ARROWS (UP AND DOWN)
  1004.  
  1005. Rotates the colors for the VU-meter.
  1006.  
  1007.  
  1008.  
  1009. SWAP
  1010.  
  1011. Swaps two colors. Use as copy.
  1012.  
  1013.  
  1014.  
  1015. CANCEL
  1016.  
  1017. Will set the last saved colors.
  1018.  
  1019.  
  1020.  
  1021. UNDO
  1022.  
  1023. [Does not work, sorry!]
  1024.  
  1025.  
  1026.  
  1027. DEF1 - DEF6
  1028.  
  1029. [Does not work, sorry!]
  1030.  
  1031.  
  1032.  
  1033. TEMPO
  1034.  
  1035. This is where you set your default CIA timing tempo. Range: 32-255.
  1036.  
  1037.  
  1038.  
  1039. SPEED
  1040.  
  1041. This is where you set your default Vblank timing speed. Range: 01-FF.
  1042.  
  1043.  
  1044.  
  1045. TIMING
  1046.  
  1047. We included this so that American users also could enjoy ProTracker, and
  1048. wouldn't have to use sonix or any other terrible music program...
  1049.  
  1050. You can choose between CIA or Vblank timing. Vblank is the timing-method
  1051. soundtrackers have been using since the dawn of time, while CIA is a
  1052. much better and accurate timing with the tempo measured in beats per
  1053. minute. Using Vblank on NTSC amigas will cause the song to play 20%
  1054. faster. With CIA, there's no difference.
  1055.  
  1056.  
  1057.  
  1058. SOFTINT
  1059.  
  1060. [No documentation exists, but audible problems have occured when using
  1061. "on".]
  1062.  
  1063.  
  1064.  
  1065. SCREEN
  1066.  
  1067. This enables you to move the screen to fit your overscan settings.
  1068.  
  1069.  
  1070.                               - Page 15 -
  1071. 15.    Setup screen - Miscellaneous
  1072.  
  1073.  
  1074.  
  1075. TUNENOTE
  1076.  
  1077. Selects which note to use for the tuning tone in the sample editor.
  1078.  
  1079.  
  1080.  
  1081. TUNE VOL
  1082.  
  1083. Selects the volume for the tuning tone.
  1084.  
  1085.  
  1086.  
  1087. RECOVER SONG
  1088.  
  1089. [Not implemented]
  1090.  
  1091.  
  1092.  
  1093. CLEAR
  1094.  
  1095. Will clear the splits. (See below)
  1096.  
  1097.  
  1098.  
  1099. SPLIT
  1100.  
  1101. You can set 4 splits on the keyboard, each with it's own sample,
  1102. splitpoint and transpose. Just type in a sample number and select the
  1103. key to split at by pressing the appropriate one. The transpose note for
  1104. each split is the first note in that split-range. Notes below the first
  1105. split will be played with the current sample. Split is great for
  1106. recording drums, or for playing untuned samples in tune (use together
  1107. with finetune).
  1108.  
  1109.  
  1110.  
  1111. ACCIDENTAL
  1112.  
  1113. Simple enough, accidental allows you to select sharp (#) or flat (b)
  1114. notes. This will not be saved with the song!
  1115.  
  1116.  
  1117.  
  1118. PRINT SONG
  1119.  
  1120. Will print the song to the path shown below the "Print Song" gadget. The
  1121. print path can be 31 chars long. (To make it actually appear on your
  1122. printer, use "PRT:")
  1123.  
  1124.  
  1125.  
  1126. PP EFF
  1127.  
  1128. Selects which crunchmode to use when crunching with powerpacker library.
  1129. The name of the modes explain it all.
  1130.  
  1131.  
  1132.  
  1133. VUMETER
  1134.  
  1135. Selects which VU-meter mode to use. "Fake" is the normal VU-meter used
  1136. in all Trackers from the beginning of time, but "real" gives a much
  1137. better impression of the actual volume of the channel.
  1138.  
  1139.  
  1140.  
  1141.                               - Page 16 -
  1142. 15.    Setup screen - Flags
  1143.  
  1144.  
  1145. 16.    Setup screen - Flags
  1146.  
  1147. SPLIT
  1148.  
  1149. Toggles between normal and split keyboard.
  1150.  
  1151.  
  1152.  
  1153. TRANS(POSE)DEL(ETE) ON/OFF
  1154.  
  1155. When on, notes transposed out of range will be deleted.
  1156.  
  1157.  
  1158.  
  1159. SOLIDSCOPE
  1160.  
  1161. When on, the quadrascopes will be rendered in a somewhat fancier way.
  1162.  
  1163.  
  1164.  
  1165. BLANKZERO
  1166.  
  1167. When off, ProTracker will show the patterndata with zeroes where no
  1168. changes take place. When set to on, these places will be rendered blank.
  1169. (Well, sort of, anyway!)
  1170.  
  1171.  
  1172.  
  1173. SHOWDEC(IMAL)
  1174.  
  1175. When on, memory sizes will be shown in decimal.
  1176.  
  1177.  
  1178.  
  1179. FILTER
  1180.  
  1181. Toggles the low-pass filter of the Amiga. (Not available on all Amigas)
  1182.  
  1183.  
  1184.  
  1185. NTSC
  1186.  
  1187. When on, ProTracker will only be visible 200 lines at a time, and scroll
  1188. in order to be able to display the entire screen. This is only useful
  1189. for users using a NTSC based video system.
  1190.  
  1191.  
  1192.  
  1193. LACED
  1194.  
  1195. When on, ProTracker will use the interlace (flickering) mode of the
  1196. Amiga in order to make all genlocks a little bit happier. 8)
  1197.  
  1198.  
  1199.  
  1200. UNDYN IFF
  1201.  
  1202. [No documentation available at time of writing.]
  1203.  
  1204.  
  1205.  
  1206. UNDYN MOD
  1207.  
  1208. [No documentation available at time of writing.]
  1209.  
  1210.  
  1211.  
  1212.                               - Page 17 -
  1213. 16.    Setup screen - Flags
  1214.  
  1215.  
  1216. OVERRIDE
  1217.  
  1218. When on, ProTracker will ignore any paths or disknames when loading a
  1219. song. All the samples will be loaded from the current sample path.
  1220.  
  1221.  
  1222.  
  1223. NOSAMPLES
  1224.  
  1225. When on, ProTracker won't load the samples when loading a song or
  1226. module.
  1227.  
  1228.  
  1229.  
  1230. SHOW DIRS
  1231.  
  1232. When on, directories will be shown in the disk operations screen.
  1233.  
  1234.  
  1235.  
  1236. LOAD LOOP
  1237.  
  1238. When on, ProTracker will load loops from IFF-samples.
  1239.  
  1240.  
  1241.  
  1242. AUTODIR ON/OFF
  1243.  
  1244. When on, ProTracker reads the current directory path automatically when
  1245. the
  1246.  is opened.
  1247.  
  1248.  
  1249.  
  1250. AUTOEXIT ON/OFF
  1251.  
  1252. When on, ProTracker will automatically exit from the disk operations
  1253. when loading a song, module, track or pattern.
  1254.  
  1255.  
  1256.  
  1257. MULTICACHE
  1258.  
  1259. [No documentation available at time of writing.]
  1260.  
  1261.  
  1262.  
  1263. CUTTOBUFF
  1264.  
  1265. If enabled, all cut operations will copy to the paste-buffer.
  1266.  
  1267.  
  1268.  
  1269. CUTTOLOOP
  1270.  
  1271. [Not implemented]
  1272.  
  1273.  
  1274.  
  1275. UPS>28kHz
  1276.  
  1277. [Not implemented]
  1278.  
  1279. 17.    Disk operations
  1280.  
  1281. The disk operations screen has a directory window at the right edge of
  1282.  
  1283.                               - Page 18 -
  1284. 17.    Disk operations
  1285.  
  1286. the screen, were you can select which files to load.
  1287.  
  1288.  
  1289.  
  1290. MAIN MENU
  1291.  
  1292. Will exit disk operations and return to the main screen.
  1293.  
  1294.  
  1295.  
  1296. PACK
  1297.  
  1298. Selects wether modules and samples should be packed using powerpacker
  1299. library.
  1300.  
  1301.  
  1302.  
  1303. SAMPFORM
  1304.  
  1305. Selects wether samples are to be saved as IFF 8SVX or as RAW 8-bit
  1306. data.
  1307.  
  1308.  
  1309.  
  1310. SAVE ICON
  1311.  
  1312. [Not implemented]
  1313.  
  1314.  
  1315.  
  1316. HIDE .INFO
  1317.  
  1318. Selects wether ProTracker should hide .info-files or not. (Icon files
  1319. used by the Workbench.)
  1320.  
  1321.  
  1322.  
  1323. RESET PATHS
  1324.  
  1325. Resets the paths to the internal paths for loading.
  1326.  
  1327.  
  1328.  
  1329. FORMAT DISK
  1330.  
  1331. Formats the disk specified by the path gadget. Should be as easy to use
  1332. as the format command on your Workbench-disk. If you don't know which
  1333. options to use, just click on "format" and wait...
  1334.  
  1335.  
  1336.  
  1337. RELABEL DISK
  1338.  
  1339. Changes the name of a disk. (DF0:?)
  1340.  
  1341.  
  1342.  
  1343. MASK
  1344.  
  1345. Specifies which files are to be shown in the filerequester.
  1346.  
  1347.  
  1348.  
  1349. PATH
  1350.  
  1351. This shows the current path. The paths for each file-type is saved in
  1352. the config file on the setup screen.
  1353.  
  1354.                               - Page 19 -
  1355. 17.    Disk operations
  1356.  
  1357.  
  1358.  
  1359.  
  1360. FILE
  1361.  
  1362. This shows the current filename.
  1363.  
  1364.  
  1365.  
  1366. MAKEDIR
  1367.  
  1368. Creates a directory.
  1369.  
  1370.  
  1371.  
  1372. RENAME FILE
  1373.  
  1374. Renames a file.
  1375.  
  1376.  
  1377.  
  1378. DELETE FILE
  1379.  
  1380. Deletes a file.
  1381.  
  1382.  
  1383.  
  1384. Here follows a lot of "mode"-like gadgets. Clicking in the small box to
  1385. the left of these gadgets (or the big gadget next to the file-name
  1386. gadget) uses the path and mask selected for the filetype and enables
  1387. loading of the selected format. Clicking direct in the mode-gadget
  1388. selects saving.
  1389.  
  1390.  
  1391.  
  1392. SAVE EXE
  1393.  
  1394. [Not implemented]
  1395.  
  1396.  
  1397.  
  1398. SAVE MODULE
  1399.  
  1400.  
  1401. Saves the current module.
  1402.  
  1403.  
  1404.  
  1405. SAVE SONG
  1406.  
  1407. Saves the current module as a song. The sampledata for the instrument is
  1408. not saved, so ProTracker will have to re-read these when reading the
  1409. song back to memory. This way of storing modules is considered obsolete,
  1410. and only loading of such files is recommended.
  1411.  
  1412.  
  1413.  
  1414. SAVE INSTR
  1415.  
  1416. [Not implemented]
  1417.  
  1418.  
  1419.  
  1420. SAVE SAMPLE
  1421.  
  1422. Saves the current sample.
  1423.  
  1424.  
  1425.                               - Page 20 -
  1426. 17.    Disk operations
  1427.  
  1428.  
  1429.  
  1430. SAVE PATT
  1431.  
  1432. [Not implemented]
  1433.  
  1434.  
  1435.  
  1436. READ DIR
  1437.  
  1438. Re-reads the selected path.
  1439.  
  1440.  
  1441.  
  1442. PARENT
  1443.  
  1444. Skips to the parent directory of your current path.
  1445.  
  1446.  
  1447.  
  1448. FREE
  1449.  
  1450. Shows amount of bytes free in the selected path.
  1451.  
  1452.  
  1453.  
  1454. All other gadgets on the disk operation screen is devices and assigns on
  1455. your system and may be pressed in order to make ProTracker make the
  1456. device/assign the current path. Pressing right button in any of these
  1457. switches through several pages.
  1458.  
  1459. 18.    Sampler - Main
  1460.  
  1461. The sampler screen consists of a sample-display, a scroll bar to move
  1462. around in the sample, and a lot of gadgets.
  1463.  
  1464.  
  1465.  
  1466. EXIT
  1467.  
  1468. Will close the sampler screen and return the bottom part of the screen
  1469. to pattern edit.
  1470.  
  1471.  
  1472.  
  1473. STOP
  1474.  
  1475. Stops the current sample from playing.
  1476.  
  1477.  
  1478.  
  1479. WAVEFORM
  1480.  
  1481. Will play the entire sample.
  1482.  
  1483.  
  1484.  
  1485. DISPLAY
  1486.  
  1487. Will play the visible part of the sample.
  1488.  
  1489.  
  1490.  
  1491. RANGE
  1492.  
  1493. Will play the selected range of the sample.
  1494.  
  1495.  
  1496.                               - Page 21 -
  1497. 18.    Sampler - Main
  1498.  
  1499.  
  1500.  
  1501. CUT
  1502.  
  1503. Will cut the selected range of the sample.
  1504.  
  1505.  
  1506.  
  1507. COPY
  1508.  
  1509. Will copy the selected range of the sample to the copy-buffer.
  1510.  
  1511.  
  1512.  
  1513. PASTE
  1514.  
  1515. Will paste the selected the copy-buffer to the current position of the
  1516. cursor.
  1517.  
  1518.  
  1519.  
  1520. SHOW RANGE
  1521.  
  1522. Will zoom in to the selected range of the sample.
  1523.  
  1524.  
  1525.  
  1526. SHOW ALL
  1527.  
  1528. Will show the entire sample.
  1529.  
  1530.  
  1531.  
  1532. BEG
  1533.  
  1534. Will put the cursorline at the beginning of the sample.
  1535.  
  1536.  
  1537.  
  1538. END
  1539.  
  1540. Will put the cursorline at the end of the sample.
  1541.  
  1542.  
  1543.  
  1544. SWAPBUF
  1545.  
  1546. Swaps copybuffer with sampledata.
  1547.  
  1548.  
  1549.  
  1550. VOLUME
  1551.  
  1552. Opens the volume requester.
  1553.  
  1554.  
  1555.  
  1556. TUNETONE
  1557.  
  1558. Will create a steady sinus tone which you can tune your samples with.
  1559.  
  1560.  
  1561.  
  1562. ZOOM OUT
  1563.  
  1564. Will zoom out a bit.
  1565.  
  1566.  
  1567.                               - Page 22 -
  1568. 18.    Sampler - Main
  1569.  
  1570.  
  1571.  
  1572. RANGE ALL
  1573.  
  1574. Select the entire sample as range.
  1575.  
  1576.  
  1577.  
  1578. SAMPLE
  1579.  
  1580. Will first enter the monitor screen. Now click right button to sample,
  1581. left to exit. The rate used will be the one specified in the box to the
  1582. immediate right of the "sample" gadget.
  1583.  
  1584.  
  1585.  
  1586. RESAMPLE
  1587.  
  1588. Transposes the sample itself. (Changing the pitch) Instructions:
  1589.     1. Turn on the tuning tone.
  1590.     2. Use the keyboard to find what note it is. Use finetune if
  1591. needed.
  1592.     3. Enter the note in the "Note:" box to the right.
  1593.     4. Press resample!
  1594.  
  1595.  
  1596.  
  1597. DISP
  1598.  
  1599. The number of bytes being shown on screen.
  1600.  
  1601.  
  1602.  
  1603. POS
  1604.  
  1605. The current postition of the cursor.
  1606.  
  1607.  
  1608.  
  1609. RANG
  1610.  
  1611. The length of the selected range.
  1612.  
  1613.  
  1614.  
  1615. INVERT
  1616.  
  1617. Turns the sample upside-down. (Flips it around the x-axis!)
  1618.  
  1619.  
  1620.  
  1621. MAXIMIZE
  1622.  
  1623. Up/down-shift the sample in order to make the best possible effects on a
  1624. normalize function (see below), and performs it. This will cause maximum
  1625. volume without distortion.
  1626.  
  1627.  
  1628.  
  1629. NORMALIZE
  1630.  
  1631. Adjusts the volume of the sample to the highest possible.
  1632.  
  1633.  
  1634.  
  1635. NORMALDC
  1636.  
  1637.  
  1638.                               - Page 23 -
  1639. 18.    Sampler - Main
  1640.  
  1641. Balances the sample in Y-direction. (Bias adjustment)
  1642.  
  1643.  
  1644.  
  1645. BACKWARDS
  1646.  
  1647. Turns the sample backwards.
  1648.  
  1649.  
  1650.  
  1651. BOOST
  1652.  
  1653. Will turn up the treble of the sample. Use this on hi-hats and snares!
  1654. If a range is selected, this will only affect the selected range.
  1655.  
  1656.  
  1657.  
  1658. INTERPOL
  1659.  
  1660. Will Delta-filter the sample. Use this on noisy basses. If the sampler a
  1661. range is selected, this will only affect the selected range.
  1662.  
  1663.  
  1664.  
  1665. UPSAMPLE
  1666.  
  1667. Will remove every second byte of the sample, halving the length and
  1668. shifting the pitch one octave up.
  1669.  
  1670.  
  1671.  
  1672. DOWNSAMPLE
  1673.  
  1674. Will double every byte of the sample, doubling the length, and shifting
  1675. the pitch one octave down.
  1676.  
  1677. 19.    Sampler - Volume requester
  1678.  
  1679. The volume requester works on the current range.
  1680.  
  1681. Set the "from" and "to" volume percentages by using the sliders, or just
  1682. type in any number you please (from 0 to 200) in the percentage boxes to
  1683. the right.
  1684.  
  1685.  
  1686.  
  1687. RAMP
  1688.  
  1689. Will ramp (calculate) the volume!
  1690.  
  1691.  
  1692.  
  1693. NORMALIZE
  1694.  
  1695. Will find the highest volume settings possible (without clipping).
  1696.  
  1697.  
  1698.  
  1699. @{ub}
  1700.  
  1701. Will set the percentages 100%-0%
  1702.  
  1703.  
  1704.  
  1705. /
  1706.  
  1707. Will set the percentages 0%-100%
  1708.  
  1709.                               - Page 24 -
  1710. 19.    Sampler - Volume requester
  1711.  
  1712.  
  1713.  
  1714.  
  1715. -
  1716.  
  1717. Will set the percentages 100%-100%
  1718.  
  1719.  
  1720.  
  1721. CANCEL
  1722.  
  1723. Will exit the volume requester.
  1724.  
  1725. 20.    Nice to know
  1726.  
  1727. This chapter explains some things about ProTracker which I weren't sure
  1728. of where to put.
  1729.  
  1730.         Pointer colors
  1731.         Keyboard shortcuts
  1732.         Effect commands
  1733.         Requesters and I/O
  1734.         Standard paths
  1735.         Keyboard percussion
  1736.         What is DYN-samples
  1737.  
  1738. 21.    Pointer colors
  1739.  
  1740. ProTracker uses the color of the pointer to tell you what's happening.
  1741. These colors are:
  1742.  
  1743.     Gray    - Nothing's happening.
  1744.     Yellow  - Playing song / pattern.
  1745.     Green   - Disk action.
  1746.     Blue    - Edit / record.
  1747.     Magenta - Waiting for input (text, number or something else).
  1748.     Cyan    - Select entry or delete.
  1749.     Red     - Something went wrong.
  1750.  
  1751. 22.    Keyboard
  1752.  
  1753. KEYBOARD
  1754.  
  1755. The keymap on ProTracker is a standard US keymap. Remember to always use
  1756. the left shift and alt, as the right ones are used for play / pattern
  1757. play.
  1758.  
  1759.     High notekeys:  2 3   5 6 7   9 0   =
  1760.                    Q W E R T Y U I O P [ ]
  1761.  
  1762.     Low notekeys:    S D   G H J   L ;
  1763.                     Z X C V B N M , . /
  1764.  
  1765.     F1 - Choose low octave (C-1 to G-3)
  1766.     F2 - Choose high octave (C-2 to B-3)
  1767.  
  1768.     F3 - Cut   (sample)
  1769.     F4 - Copy  (sample)
  1770.     F5 - Paste (sample)
  1771.  
  1772.     shift+F3 - Cut track to buffer
  1773.     shift+F4 - Copy track to buffer
  1774.     shift+F5 - Paste track-buffer to track
  1775.  
  1776.     alt+F3 - Cut whole pattern to buffer
  1777.     alt+F4 - Copy whole pattern to buffer
  1778.     alt+F5 - Paste patt-buffer to pattern
  1779.  
  1780.                               - Page 25 -
  1781. 22.    Keyboard
  1782.  
  1783.  
  1784.     ctrl+F3 - Cut commands to buffer
  1785.     ctrl+F4 - Copy commands to buffer
  1786.     ctrl+F5 - Paste cmd-buffer to track
  1787.  
  1788.     F6 - Go to patternposition 0
  1789.     F7 - Go to patternposition 16
  1790.     F8 - Go to patternposition 32
  1791.     F9 - Go to patternposition 48
  1792.     F10- Go to patternposition 63
  1793.  
  1794.     shift+F6-F10 - Store current patternposition on selected F-key
  1795.     alt+F6-F10   - Play pattern from the stored patternposition
  1796.     ctrl+F6-F10  - Record from the stored patternposition
  1797.  
  1798.     Esc - Exit a lots of things.
  1799.  
  1800.     shift+Return    - Insert blank note at cursorpos
  1801.                       and move the rest down.
  1802.     shift+Backspace - Delete note above cursorpos and move the rest up.
  1803.  
  1804.     alt+Return    - As above, but with all 4 tracks
  1805.     alt+Backspace - As above, but with all 4 tracks
  1806.  
  1807.     ctrl+Return    - Push cmds one down
  1808.     ctrl+Backspace - Drag cmds one up
  1809.  
  1810.     ctrl+0-9 - Select how many steps ProTracker will jump down each
  1811. time
  1812.                you insert a note (only in edit-mode)
  1813.  
  1814.     alt+cursor right   - patternnumber up
  1815.     alt+cursor left    - patternnumber down
  1816.     shift+cursor right - song-position up
  1817.     shift+cursor left  - song-position down
  1818.  
  1819.     ctrl+cursor left   - samplenumber up
  1820.     ctrl+cursor right  - samplenumber down
  1821.  
  1822.     Space - Toggle between stop/edit-mode
  1823.  
  1824.     < (beside Z) - Stop all sound
  1825.     right Amiga  - Play Pattern
  1826.     right Alt    - Play Song
  1827.     right Shift  - Record
  1828.     Caps Lock    - Toggle Keyrepeat on/off
  1829.  
  1830.     Del       - Delete note under cursor
  1831.     alt+Del   - Delete command only
  1832.     shift+Del - Delete note and command
  1833.  
  1834.     On Numeric pad:
  1835.  
  1836.     0 - Select Sample $0
  1837.     1st row    - Select Sample $1-$4
  1838.     2nd row    - Select Sample $5-$8
  1839.     3rd row    - Select Sample $9-$c
  1840.     4th row    - Select Sample $d-$f
  1841.     Just Enter - Select Sample $10
  1842.  
  1843.     Holding Enter + the other keys, will select sample $11-$1F
  1844.     (Not on A1200, that is!) :(
  1845.  
  1846.     Period (.) - Kill current sample
  1847.  
  1848.     Left Amiga (Plus keys below) - Transposing
  1849.  
  1850.  
  1851.                               - Page 26 -
  1852. 22.    Keyboard
  1853.  
  1854.     Sample/Track            Sample/Pattern
  1855.     ----------------------------------
  1856.     1 - Note Up             2 - Note Up
  1857.     Q - Note Down           W - Note Down
  1858.     A - Octave Up           S - Octave Up
  1859.     Z - Octave Down         X - Octave Down
  1860.  
  1861.     All/Track           All/Pattern
  1862.     -------------------------------
  1863.     3 - Note Up             4 - Note Up
  1864.     E - Note Down           R - Note Down
  1865.     D - Octave Up           F - Octave Up
  1866.     C - Octave Down         V - Octave Down
  1867.  
  1868.     Tab      - Move cursor to next track
  1869.     Shft+Tab - Move cursor to prev track
  1870.  
  1871.     ctrl+A - Toggle channel on/off (+shift = solo channel)
  1872.     ctrl+B - Mark block
  1873.     ctrl+C - Copy block to buffer
  1874.     ctrl+D - Delete block, drag notes up
  1875.     ctrl+E - expand track
  1876.     ctrl+F - toggle filter on/off
  1877.     ctrl+G - Boost all samples
  1878.     ctrl+H - Transpose block up
  1879.     ctrl+I - Insert block, push notes down
  1880.     ctrl+J - Join-paste block
  1881.     ctrl+K - Kill to end of track (+shift = to start of track)
  1882.     ctrl+L - Transpose block down
  1883.     ctrl+M - Toggle multikeyboard on/off
  1884.     ctrl+N - Re-mark last block
  1885.     ctrl+O - Contract track
  1886.     ctrl+P - Paste block
  1887.     ctrl+Q - Unmute all channels
  1888.     ctrl+R - Restore F6-F10 positions
  1889.     ctrl+S - Toggle split keyboard on/off
  1890.     ctrl+T - swap tracks
  1891.     ctrl+U - undo last change
  1892.     ctrl+V - Filter all samples
  1893.     ctrl+W - Polyphonize block
  1894.     ctrl+X - Cut block to buffer
  1895.     ctrl+Y - Backwards block
  1896.     ctrl+Z - Restore Effects
  1897.  
  1898.     shft+0-9 - Store current command on selected key
  1899.     alt+0-9  - Insert command in current track
  1900.  
  1901.     alt+"\" - Copy command above cursor to current patternposition.
  1902.     alt+"=" - Copy command above cursor to current patternposition
  1903.               and add one to the value.
  1904.     alt+"-" - Copy command above cursor to current patternposition
  1905.               and subtract one from the value.
  1906.  
  1907.     alt+A - Monitor/Start sampling
  1908.     alt+B - Boost sample
  1909.     alt+C - Toggle channel 3
  1910.     alt+D - Go to disk operations screen
  1911.     alt+F - Filter sample
  1912.     alt+I - Toggle AutoinsertEffect on/off
  1913.     alt+K - Delete current sample/track
  1914.     alt+M - Toggle metronome on/off
  1915.     alt+Q - Quit ProTracker
  1916.     alt+R - Resample
  1917.     alt+S - Go to sampler screen
  1918.     alt+T - Tuning tone
  1919.     alt+V - Toggle channel 4
  1920.     alt+X - Toggle channel 2
  1921.  
  1922.                               - Page 27 -
  1923. 22.    Keyboard
  1924.  
  1925.     alt+Y - Save all samples
  1926.     alt+Z - Toggle channel 1
  1927.  
  1928.     alt+shift+M - Set metrochannel to current channel
  1929.  
  1930.     \                  - Set keyboard percussion mode
  1931.     Alt+any keypad key - tune percussion note
  1932.  
  1933.     Return    - Step one note forward
  1934.  
  1935.     Backspace - Step one note backward
  1936.  
  1937.     LeftAmiga+N - ScreenToBack
  1938.     LeftAmiga+M - ScreenToFront
  1939.  
  1940.     When inserting, pasting or join-pasting, hold down shift to keep
  1941.     the cursor from jumping to the end of the block. e.g. shft+ctrl+P
  1942.  
  1943. 23.    Effect commands
  1944.  
  1945. EFFECT COMMANDS
  1946.  
  1947. Effect commands on ProTracker should be compatible with all other
  1948. trackers.
  1949.  
  1950.     0 - None/arpeggio           8 - [Not used]
  1951.     1 - Slide pitch up          9 - Sample offset
  1952.     2 - Slide pitch down        A - Slide volume
  1953.     3 - Toneportamento          B - Jump to position
  1954.     4 - Vibrato                 C - Set volume
  1955.     5 - 3 + A                   D - Break pattern
  1956.     6 - 4 + A                   E - Miscellaneous commands (See below)
  1957.     7 - Tremolo                 F - Set speed
  1958.  
  1959.  
  1960.  
  1961. MISCELLANEOUS COMMANDS
  1962.  
  1963. The E command has been altered to contain more commands than one.
  1964.  
  1965.     E0 - Set low-pass filter    E8 - [Not used]
  1966.     E1 - Fineslide pitch up     E9 - Retrig note
  1967.     E2 - Fineslide pitch down   EA - Fineslide volume up
  1968.     E3 - Glissando control      EB - Fineslide volume down
  1969.     E4 - Vibrato control        EC - Cut note
  1970.     E5 - Set finetune           ED - Delay note
  1971.     E6 - Pattern loop           EE - Delay pattern
  1972.     E7 - Tremolo control        EF - Invert loop
  1973.  
  1974. 24.    Arpeggio effect command
  1975.  
  1976. Cmd 0. Arpeggio [Range:$0-$F/$0-$F]
  1977.  
  1978. Usage: $0 + 1st halfnote add
  1979.           + 2nd halfnote add
  1980.  
  1981. Arpeggio is used to simulate chords. This is done by rapidly changing
  1982. the pitch between 3(or 2) different notes. It sounds very noisy and
  1983. grainy on most samples, but ok on monotone ones.
  1984.  
  1985. Example: C-300047  C-major chord: (C+E+G  or C+4+7 halfnotes)
  1986.          C-300037  C-minor chord: (C+D#+G or C+3+7 halfnotes)
  1987.  
  1988. 25.    Slide up effect command
  1989.  
  1990. Cmd 1. Portamento up [Speed:$00-$FF]
  1991.  
  1992.  
  1993.                               - Page 28 -
  1994. 25.    Slide up effect command
  1995.  
  1996. Usage: $1 + portamento speed
  1997.  
  1998. Portamento up will simply slide the sample pitch up. You can NOT slide
  1999. higher than B-3! (Period 113)
  2000.  
  2001. Example: C-300103  1 is the command, 3 is the portamentospeed.
  2002.  
  2003. NOTE: The portamento will be called as many times as the speed of the
  2004. song. This means that you'll sometimes have trouble sliding accuratly.
  2005. If you change the speed without changing the sliderates, it will sound
  2006. bad...
  2007.  
  2008. 26.    Slide down effect command
  2009.  
  2010. Cmd 2. Portamento down [Speed:$00-FF]
  2011.  
  2012. Usage: $2 + portamento speed
  2013.  
  2014. Just like command 1, except that this one slides the pitch down instead.
  2015. (Adds to the period).
  2016.  
  2017. You can NOT slide lower than C-1! (Period 856)
  2018.  
  2019. Example: C-300203, where 2 is the command, 3 is the portamentospeed.
  2020.  
  2021. 27.    Toneportamento effect command
  2022.  
  2023. Cmd 3. Tone-portamento [Speed:$00-$FF]
  2024.  
  2025. Usage: Dest-note + $3 + slidespeed
  2026.  
  2027. This command will automatically slide from the old note to the new. You
  2028. don't have to worry about which direction to slide, you need only set
  2029. the slide speed. To keep on sliding, just select the command $3 + 00.
  2030.  
  2031. Example: A-200000  First play a note.
  2032.          C-300305  C-3 is the note to slide to, 3 the command,
  2033.                    and 5 the speed.
  2034.  
  2035. 28.    Vibrato effect command
  2036.  
  2037. Cmd 4. Vibrato [Rate:$0-$F,Dpth:$0-$F]
  2038.  
  2039. Usage: $4 + vibratorate + vibratodepth
  2040.  
  2041. Example: C-300481  4 is the command, 8 is the speed of the vibrato,
  2042.                    and 1 is the depth of the vibrato.
  2043.  
  2044. To keep on vibrating, just select the command $4 + 00. To change the
  2045. vibrato, you can alter the rate, depth or both. Use command E4x to
  2046. change the vibrato-waveform.
  2047.  
  2048. 29.    Toneportamento and volumeslide effect command
  2049.  
  2050. Cmd 5. ToneP + Volsl [Spd:$0-$F/$0-$F]
  2051.  
  2052. Usage: $5 + upspeed + downspeed
  2053.  
  2054. This command will continue the current toneportamento and
  2055. slide the volume at the same time. Compatible with Noisetracker 2.0.
  2056.  
  2057. Example: C-300503  3 is the speed to turn the volume down.
  2058.          C-300540  4 is the speed to slide it up.
  2059.  
  2060. 30.    Vibrato and volumeslide effect command
  2061.  
  2062. Cmd 6. Vibra + Volsl [Spd:$0-$F/$0-$F]
  2063.  
  2064.                               - Page 29 -
  2065. 30.    Vibrato and volumeslide effect command
  2066.  
  2067.  
  2068. Usage: $6 + upspeed + downspeed
  2069.  
  2070. This command will continue the current vibrato and slide the volume at
  2071. the same time. Compatible with Noisetracker 2.0.
  2072.  
  2073. Example: C-300605  5 is the speed to turn the volume down.
  2074.          C-300640  4 is the speed to slide it up.
  2075.  
  2076. 31.    Tremolo effect command
  2077.  
  2078. Cmd 7. Tremolo [Rate:$0-$F,Dpth:$0-$F]
  2079.  
  2080. Usage: $7 + tremolorate + tremolodepth
  2081.  
  2082. Tremolo vibrates the volume.
  2083.  
  2084. Example: C-300794  7 is the command, 9 is the speed of the tremolo,
  2085.                    and 4 is the depth of the tremolo.
  2086.  
  2087. To keep on tremoling, just select the command $7 + 00. To change the
  2088. tremolo, you can alter the rate, depth or both. Use command E7- to
  2089. change the tremolo-waveform.
  2090.  
  2091. 32.    Sample offset effect command
  2092.  
  2093. Cmd 9. Set SampleOffset [Offs:$00-$FF]
  2094.  
  2095. Usage: $9 + Sampleoffset
  2096.  
  2097. This command will play from a chosen position in the sample, and not
  2098. from the beginning. The two numbers equal the two first numbers in the
  2099. length of the sample. Handy for speech samples.
  2100.  
  2101. Example: C-300923  Play sample from offset $2300.
  2102.  
  2103. 33.    Volume slide effect command
  2104.  
  2105. Cmd A. Volumeslide [Speed:$0-$F/$0-$F]
  2106.  
  2107. Usage: $A + upspeed + downspeed
  2108.  
  2109. Example: C-300A05  5 is the speed to turn the volume down.
  2110.          C-300A40  4 is the speed to slide it up.
  2111.  
  2112. NOTE: The slide will be called as many times as the speed of the song.
  2113. The slower the song, the more the volume will be changed on each note.
  2114.  
  2115. 34.    Position jump effect command
  2116.  
  2117. Cmd B. Position-jump [Pos:$00-$7F]
  2118.  
  2119. Usage: $B + position to continue at
  2120.  
  2121. Example: C-300B01  B is the command, 1 is the position to
  2122.                    restart the song at.
  2123.  
  2124. This command will also perform a pattern-break (see 2 pages below).
  2125.  
  2126. You can use this command instead of restart as on Noisetracker, but you
  2127. must enter the position in hex!
  2128.  
  2129. 35.    Set volume effect command
  2130.  
  2131. Cmd C. Set volume [Volume:$00-$40]
  2132.  
  2133. Usage: $C + new volume
  2134.  
  2135.                               - Page 30 -
  2136. 35.    Set volume effect command
  2137.  
  2138.  
  2139. Well, this old familiar command will set the current volume to your own
  2140. selected. The highest volume is $40. All volumes are represented in hex.
  2141. (Programmers do it in hex, you know!)
  2142.  
  2143. Example: C-300C10  C is the command, 10 is the volume (16 decimal).
  2144.  
  2145. 36.    Pattern break effect command
  2146.  
  2147. Cmd D. Pattern-break [Pattern-pos:00-63, decimal]
  2148.  
  2149. Usage: $D + pattern-position
  2150.  
  2151. This command just jumps to the next song-position, and continues play
  2152. from the patternposition you specify.
  2153.  
  2154. Example: C-300D00  Jump to the next song-position and continue play
  2155. from
  2156.                    patternposition 00.
  2157.      Or: C-300D32  Jump to the next song-position and continue play
  2158. from
  2159.                    patternposition 32 instead.
  2160.  
  2161. 37.    Adjust tempo effect command
  2162.  
  2163. Cmd F. Set speed [Speed:$00-$FF]
  2164.  
  2165. Usage: $F + speed
  2166.  
  2167. This command will set the speed of the song.
  2168.  
  2169. blank: Range 01-FF - Normal timing
  2170.   CIA: Range 01-1F - Set vblank speeds
  2171.                      with CIA timing.
  2172.   CIA: Range 20-FF - Set BPM speeds,
  2173.                      range 32-255.
  2174.  Both: Range 00    - STOP song.
  2175.  
  2176. 38.    Set filter miscellaneous effect command
  2177.  
  2178. Cmd E0. Set filter [Range:$0-$1]
  2179.  
  2180. Usage: $E0 + filter-status
  2181.  
  2182. This command changes the status of the low-pass filter of your Amiga.
  2183. This filter is not present in the A1000 and some very old A500s and
  2184. A200s, but most computers are equipped with it. (If you've got one of
  2185. these, please leave this switch alone, since flipping it constantly
  2186. garbles the sound.)
  2187.  
  2188. Example: C-300E01  disconnects filter (turns power LED off)
  2189.          C-300E00  connects filter (turns power LED on)
  2190.  
  2191. 39.    Fineslide up miscellaneous effect command
  2192.  
  2193. Cmd E1. Fineslide up [Range:$0-$F]
  2194.  
  2195. Usage: $E1 + value
  2196.  
  2197. This command works just like the normal portamento up, except that it
  2198. only slides up once. It does not continue sliding during the length of
  2199. the note.
  2200.  
  2201. Example: C-300E11  Slide up 1 at the beginning of the note.
  2202.  
  2203. (Great for creating chorus effects)
  2204.  
  2205.  
  2206.                               - Page 31 -
  2207. 39.    Fineslide down miscellaneous effect command
  2208.  
  2209.  
  2210. 40.    Fineslide down miscellaneous effect command
  2211.  
  2212. Cmd E2. Fineslide down [Range:$0-$F]
  2213.  
  2214. Usage: $E2 + value
  2215.  
  2216. This command works just like the normal portamento down, except that it
  2217. only slides down once. It does not continue sliding during the length of
  2218. the note.
  2219.  
  2220. Example: C-300E26  Slide up 6 at the beginning of the note.
  2221.  
  2222. 41.    Glissando control miscellaneous effect command
  2223.  
  2224. Cmd E3. Glissando Ctrl [Range:$0-$1]
  2225.  
  2226. Usage: $E3 + Glissando-Status
  2227.  
  2228. Glissando must be used with the tone-portamento command. When glissando
  2229. is activated, toneportamento will slide a halfnote at a time, instead of
  2230. a straight slide.
  2231.  
  2232. Example: C-300E31  Turn Glissando on.
  2233.          C-300E30  Turn Glissando off.
  2234.  
  2235. 42.    Vibrato control miscellaneous effect command
  2236.  
  2237. Cmd E4. Set vibrato waveform [Range:$0-$3]" link "Vibrato effect
  2238. command" 0} waveform [Range:$0-$3]
  2239.  
  2240. Usage: $E4 + vibrato-waveform
  2241.  
  2242. Example: C-300E40  Set sine(default)
  2243.               E44  Don't retrig WF
  2244.          C-300E41  Set Ramp Down
  2245.               E45  Don't retrig WF
  2246.          C-300E42  Set Squarewave
  2247.               E46  Don't retrig WF
  2248.          C-300E43  Set Random
  2249.               E47  Don't retrig WF
  2250.  
  2251. 43.    Set finetune miscellaneous effect command
  2252.  
  2253. Cmd E5. Set finetune [Range:$0-$F]
  2254.  
  2255. Usage: $E5 + finetune-value
  2256.  
  2257. Example: C-300E51  Set finetune to 1.
  2258.  
  2259. Use these tables to figure out the finetune-value.
  2260.  
  2261.     Finetune: +7 +6 +5 +4 +3 +2 +1  0
  2262.        Value:  7  6  5  4  3  2  1  0
  2263.  
  2264.     Finetune: -1 -2 -3 -4 -5 -6 -7 -8
  2265.        Value:  F  E  D  C  B  A  9  8
  2266.  
  2267. 44.    Pattern loop miscellaneous effect command
  2268.  
  2269. Cmd E6. PatternLoop [Loops:$0-$F]
  2270.  
  2271. Usage: $E6 + number of loops
  2272.  
  2273. This command will loop a part of a pattern.
  2274.  
  2275. Example: C-300E60  Set loopstart.
  2276.  
  2277.                               - Page 32 -
  2278. 44.    Pattern loop miscellaneous effect command
  2279.  
  2280.          C-300E63  Jump to loop 3 times before playing on.
  2281.  
  2282. 45.    Tremolo control miscellaneous effect command
  2283.  
  2284. Cmd E7. Set tremolo waveform [Range:$0-$3]" link "Tremolo effect
  2285. command" 0} waveform [Range:$0-$3]
  2286.  
  2287. Usage: $E7 + tremolo-waveform
  2288.  
  2289. Example: C-300E70  Set sine(default)
  2290.               E74  Don't retrig WF
  2291.          C-300E71  Set Ramp Down
  2292.               E75  Don't retrig WF
  2293.          C-300E72  Set Squarewave
  2294.               E76  Don't retrig WF
  2295.          C-300E73  Set Random
  2296.               E77  Don't retrig WF
  2297.  
  2298. 46.    Retrig note miscellaneous effect command
  2299.  
  2300. Cmd E9. Retrig note [Value:$0-$F]
  2301.  
  2302. Usage: $E9 + Tick to Retrig note at.
  2303.  
  2304. This command will retrig the same note before playing the next. Where to
  2305. retrig depends on the speed of the song. If you retrig with 1 in speed 6
  2306. that note will be trigged 6 times in one note slot. Retrig on hi-hats!
  2307.  
  2308. Example: C-300F06  Set speed to 6.
  2309.          C-300E93  Retrig at tick 3 out of 6.
  2310.  
  2311. 47.    Fine volumslide up miscellaneous effect command
  2312.  
  2313. Cmd EA. FineVolsl up [Range:$0-$F]
  2314.  
  2315. Usage: $EA + value
  2316.  
  2317. This command works just like the normal volumeslide up, except that it
  2318. only slides up once. It does not continue sliding during the length of
  2319. the note.
  2320.  
  2321. Example: C-300EA3  Slide volume up 1 at the beginning of the note.
  2322.  
  2323. 48.    Fine volumslide down miscellaneous effect command
  2324.  
  2325. Cmd EB. FineVolsl down [Range:$0-$F]
  2326.  
  2327. Usage: $EB + value
  2328.  
  2329. This command works just like the normal volumeslide down, except that it
  2330. only slides down once. It does not continue sliding during the length of
  2331. the note.
  2332.  
  2333. Example: C-300EB6  Slide volume down 6 at the beginning of the note.
  2334.  
  2335. 49.    Cut note miscellaneous effect command
  2336.  
  2337. Cmd EC. Cut note [Value:$0-$F]
  2338.  
  2339. Usage: $EC + Tick to cut note at.
  2340.  
  2341. This command will cut the note at the selected tick, creating extremely
  2342. short notes.
  2343.  
  2344. Example: C-300F06  Set speed to 6.
  2345.          C-300EC3  Cut at tick 3 out of 6.
  2346.  
  2347.  
  2348.                               - Page 33 -
  2349. 49.    Cut note miscellaneous effect command
  2350.  
  2351. Note that the note is not really cut, the volume is just turned down.
  2352.  
  2353. 50.    Delay note miscellaneous effect command
  2354.  
  2355. Cmd ED. NoteDelay [Value:$0-$F]
  2356.  
  2357. Usage: $ED + ticks to delay note.
  2358.  
  2359. This command will delay the note to the selected tick.
  2360.  
  2361. Example: C-300F06  Set speed to 6.
  2362.          C-300ED3  Play note at tick 3 out of 6.
  2363.  
  2364. If you use ED0, the note will be delayed a little anyway. You can play
  2365. the same note on two channels, delay one, and get a nice flanging
  2366. effect.
  2367.  
  2368. 51.    Delay pattern miscellaneous effect command
  2369.  
  2370. Cmd EE. PatternDelay [Notes:$0-$F]
  2371.  
  2372. Usage: $EE + notes to delay pattern.
  2373.  
  2374. This command will delay the pattern the selected numbers of notes.
  2375.  
  2376. Example: C-300EE8  Delay pattern 8 notes before playing on.
  2377.  
  2378. All other effects are still active when the pattern is being delayed.
  2379.  
  2380. 52.    Invert loop miscellaneous effect command
  2381.  
  2382. Cmd EF. Invert Loop [Speed:$0-$F]
  2383.  
  2384. Usage: $EF + Invertspeed
  2385.  
  2386. This command will need a short loop ($10,20,40,80 etc. bytes) to work.
  2387. It will invert the loop byte by byte. Sounds better than funkrepeat...
  2388.  
  2389. Example: C-300EF8 Set invspeed to 8.
  2390.  
  2391. To turn off the inverting, set invspeed to 0, or press ctrl + Z.
  2392.  
  2393. This effect will trash the sample.
  2394.  
  2395. 53.    Requesters and I/O
  2396.  
  2397. ARE YOU SURE? REQUESTER
  2398.  
  2399. In addition to the gadgets, you can use "Y" or Return for Yes, and "N"
  2400. or ESC for No.
  2401.  
  2402.  
  2403.  
  2404. THE TEXT-INPUT ROUTINE
  2405.  
  2406. Now this is really simple. Clicking on a textline will enable you to
  2407. edit it. Some text lines are longer than they seem, so use the arrowkeys
  2408. to scroll back and forth in the text. The text input mode is just like
  2409. an ordinary text editor. You can use backspace, delete, space and such.
  2410. In text-input mode you can also use the numeric pad for entering
  2411. numbers. Pressing the right mousebutton will clear the textline and exit
  2412. the editing. Use ESC or return to just exit.
  2413.  
  2414.  
  2415.  
  2416. THE NUMBERGADGETS
  2417.  
  2418.  
  2419.                               - Page 34 -
  2420. 53.    Requesters and I/O
  2421.  
  2422. Click on them and type in the value (Hex or Dec). ESC or return aborts.
  2423.  
  2424.  
  2425.  
  2426. ARROWGADGETS
  2427.  
  2428. Pressing both the left and right button on the arrow-gadgets will speed
  2429. them up a bit. All numbergadgets except Finetune and Sample allows you
  2430. to click in the gadget and type in the desired value. Holding the right
  2431. mousebutton while pressing them will zero the value.
  2432.  
  2433. 54.    Standard paths
  2434.  
  2435. STANDARD PATHS
  2436.  
  2437. ProTracker has several standard-paths which it uses when searching for
  2438. things. Some of these may be configured, while others can't. These are:
  2439.  
  2440.         Config-file             "S:"
  2441.         Powerpacker-library     "LIBS:"
  2442.         Executable modules*     "ST-00:Executable/"
  2443.         Modules                 "ST-00:Modules/"
  2444.         Songs                   "ST-00:Songs/"
  2445.         Instruments*            "ST-00:Instruments/"
  2446.         Samples                 "ST-01:"
  2447.         Patterns*               "ST-00:Patterns/"
  2448.  
  2449. *=Not implemented yet.
  2450.  
  2451. 55.    Keyboard percussion
  2452.  
  2453. KEYBOARD PERCUSSION
  2454.  
  2455. Use backspace '\' to toggle modes. One or more dots will appear to the
  2456. right of the freemem display.
  2457.  
  2458.     No dots : Normal keypad.
  2459.       1 dot : Drumpad.
  2460.      2 dots : Drumpad - Edit/Rec possible.
  2461.  
  2462. Use Alt + keypad key to set the note for the sample.
  2463.  
  2464. With 'drumpad' selected, selecting a sample using the keypad will also
  2465. play the sample. This is nice when browsing through the samples of
  2466. modules.
  2467.  
  2468. 56.    What is DYN samples?
  2469.  
  2470. WHAT IS DYN SAMPLES?
  2471.  
  2472. DYN samples is a new (and revolutionary) way of playing 16-bit samples
  2473. with a 8 - 14 bit replay quality. Your Amiga achieves this by cheating a
  2474. lot, and this sure does take cpu time. No official replay exist to play
  2475. module utilising modules with these samples, so use for own pleasure
  2476. only. Maestro 16-bit mono IFF samples are currently the only supported.
  2477. :(
  2478.  
  2479. The big drawbacks using DYN-samples is that click and ticks may occur.
  2480. Also, playing DYN samples at low volumes may cause distortion.
  2481.  
  2482. 57.    How to create music using PT
  2483.  
  2484. I know. The information in this chapter may not be complete nor easy to
  2485. understand, but it's atleast far better than any earlier attempt to
  2486. explain how to use ProTracker in general. Suggestions are welcome!
  2487.  
  2488.         What is a module?
  2489.  
  2490.                               - Page 35 -
  2491. 57.    How to create music using PT
  2492.  
  2493.         Patterns
  2494.         Position-table
  2495.         Samples
  2496.  
  2497. 58.    What is a module?
  2498.  
  2499. History
  2500.  
  2501. ProTracker's musicfiles are normally called modules. The reason for this
  2502. is that way back, in the days of SoundTracker v1.0, Karsten Obarski (the
  2503. author) thought that the best way to save music was as songs with only
  2504. references to the instrument's names to make it possible to reload them
  2505. each time the song was reloaded into SoundTracker.
  2506.  
  2507. The module format was implemented in SoundTracker v1.0 allright, but it
  2508. was only intended to be used when programmers wanted to replay the
  2509. modules in their productions and not as temporary storage, as it is
  2510. being used today. Because of this, SoundTracker couldn't load modules
  2511. before version v2.2!
  2512.  
  2513. The module-format used today is created by Mahoney and Kaktus which made
  2514. NoiseTracker in July - August 1989, another tracker-clone. The only big
  2515. defference they made to the format was that they increased the number of
  2516. samples from 15 to 31.
  2517.  
  2518.  
  2519. What's in a module?
  2520.  
  2521. A module basically contains this info:
  2522.  
  2523.   * Module name
  2524.   * Samples (name, length, finetune, volume, repeat, replen and
  2525.     the actual audio data)
  2526.   * Which pattern to play at each position of your module.
  2527.   * Pattern data
  2528.  
  2529. The ProTracker v2.3 also outputs files called "mod!modname" which
  2530. contains names for each pattern in the module. This will be featured in
  2531. ProTracker v3.x when the new IFF format is implemented.
  2532.  
  2533. A totally empty module (no samples and one pattern) occupies 2128 bytes
  2534. of disk space, while the (theoretical) largest module one would be able
  2535. to create would occupy 4326460 bytes! (Even more if DYN samples were
  2536. used!)
  2537.  
  2538. 59.    Patterns
  2539.  
  2540. What is patterns?
  2541.  
  2542. Any piece of music written with ProTracker is built up from patterns.
  2543. Each pattern is built up from four tracks, one for each of the Amiga's
  2544. audiochannels. A module may contain up to 64 patterns.
  2545.  
  2546. A pattern is 64 steps long. The magnified line is always the one you
  2547. edit. If you need shorter patterns, use the
  2548. patternbreak effect command.
  2549.  
  2550. A track is built up of steps like this:
  2551.  
  2552.  C-3 01 C20
  2553.  (1) (2)(3)
  2554.  
  2555. (1) - The first two characters describes the note to play. The "-" may
  2556. be replaced by "#" or "b" to describe a flat or a sharp note, depending
  2557. on you settings in the setup-screen. The third character is the octave
  2558. to play the note in. ProTracker supports 3 octaves (1 through 3).
  2559.  
  2560.  
  2561.                               - Page 36 -
  2562. 59.    Patterns
  2563.  
  2564. (2) This is the sample-number to play. Valid numbers are hexadecimal 00
  2565. through 1F. Sample 0 doesn't really exists but will play the last used
  2566. sample for that channel without resetting the volume.
  2567.  
  2568. (3) This is the effect-command to play.
  2569.  
  2570. To sum it up: The C-3 is the note being played. 01 is the samplenumber,
  2571. and the three last digits are the effect command, in this case, set
  2572. volume to $20 (C-Command, 20-Value).
  2573.  
  2574.  
  2575. Effect tips
  2576.  
  2577. You can set the volume to the volume of a specific instrument without
  2578. actually trigging the sample.
  2579.  
  2580. e.g. "---01000" will set the volume for sample 1 without playing a
  2581. note.
  2582.  
  2583. Try setting the volume and sliding the volume down at the same time:
  2584.         C-301A08        <--- (If no sample is playing, no sound will be
  2585.         ---01A08              heard at all...)
  2586.         ---01A08
  2587.  
  2588. This will create a strange arpeggiato effect.
  2589.  
  2590. 60.    Position table
  2591.  
  2592. What is the position-table?
  2593.  
  2594. ProTracker holds a table with information about which order to play the
  2595. patterns. You may freely define the size of this table. This table may
  2596. be up to 128 positions, and each position may contain any of your
  2597. patterns.
  2598.  
  2599. When ProTracker plays your module it first play position 0, then
  2600. position 1 and so on until it reaches the end of your position-table.
  2601. When this occurs, ProTracker jumps back to position 0. If you want
  2602. ProTracker to jump to another position, you must use the position jump
  2603. effect command at the end of the pattern at the last position.
  2604.  
  2605.  
  2606. How to edit the position-table
  2607.  
  2608. The position-table is controlled using the three gadgets labeled "Pos",
  2609. "Pattern" and "Length". The "Pos"-gadget states which position you are
  2610. currently editing, while the "Pattern"-gadget states which pattern to
  2611. play at that position and finally the "Length"-gadgets sets the length
  2612. of your position-table.
  2613.  
  2614. You must remember, though, that the length also implies position 0. This
  2615. means that if your length is 2, position 0 and 1 will be played. The "I"
  2616. and "D" gadgets are your friends and are used for inserting and deleting
  2617. positions.
  2618.  
  2619. 61.    Samples
  2620.  
  2621. What are samples?
  2622.  
  2623. Samples are sound, converted from analog signals to digital (numbers).
  2624. When your Amiga plays these sounds it converts them back to analog
  2625. signals and feeds them to your monitor or amplifier. In memory, samples
  2626. are stored as a big bunch of numbers. The easiest way to think of
  2627. samples is recorded sound.
  2628.  
  2629.  
  2630. What decides the quality of samples? (Hardware approach)
  2631.  
  2632.                               - Page 37 -
  2633. 61.    Samples
  2634.  
  2635.  
  2636. The Amiga's sample-resolution of 8 bit means that it utilises 256 values
  2637. (2^8) for describing the amplitude of the sound-wave. A CD-player with
  2638. 16 bits uses thus 65536 values and therefore gives a more accurate
  2639. reproduction lof the original sound.
  2640.  
  2641. Another thing which (heavily) influences the quality of a sample is how
  2642. often the hardware (in this case, your Amiga) is capable of send out a
  2643. new value. If you send out a zillion values each second, there's small
  2644. changes you would miss a change in the sound-wave. Easy? Your Amiga has
  2645. actually no absolute limits for how fast it is able to reproduce sound,
  2646. but the easiest output method involves timing the sound output to the
  2647. Amiga's display hardware. At normal resolutions this means a maximum of
  2648. ~28000 Hz. In comparison a CD player outputs at a rate of 44100 Hz.
  2649.  
  2650. It is generally a common mistake to refer to the Amiga's maximum rate as
  2651. 28000 samples/second. In order for one hertz (Hz) to occur, you need a
  2652. positive and a negative value. To put it another way, each hertz
  2653. consists of two sample values. This means that in the Amiga's maximum
  2654. sample rate a sample of 56000 bytes would replay in one second!
  2655.  
  2656. The sample rate is not constant, as it is used to specify the note to
  2657. play the sample with. 28000 Hz equals the A-3 note in ProTracker, while
  2658. the A-2 is half the rate (14000 Hz).
  2659.  
  2660.  
  2661. Where to get samples from
  2662.  
  2663. Sampling samples yourself is perhaps the easiest (and funniest) way to
  2664. achieve samples. In order for this to work, you need to buy a sampler
  2665. (generally very cheap, about £20 should get you a low-end one) and have
  2666. a source to sample from (expensive). Sampling from CDs is difficult and
  2667. often there are other instruments in the background, so obtaining all
  2668. the samples you need from CDs is nearly impossible. The second
  2669. alternative is buying a keyboard to sample from, but since most of these
  2670. are pretty expensive (the price is usually proportional to the sound
  2671. quality) I wouldn't advice anyone to buy a keyboard unless they're
  2672. pretty sure they want to do music.
  2673.  
  2674. Another (well-hated) way to get samples from is by stealing from other
  2675. modules. It is generally a bad idea to load a module and use clear song
  2676. in order to use the exact samples as another module. The better approach
  2677. is to save samples from all modules and mix them together on a HD or
  2678. create your own sampledisks. This way (if you catalogize them properly)
  2679. you could easily find the sample you need when you need it.
  2680.  
  2681. The third way to obtain samples is obtaining PD sample disks. Your could
  2682. buy the AM/FM series sampledisks (from Bjørn A Lynne) or you could write
  2683. to a PD company. (Most of these has a large variety of sample disks.)
  2684.  
  2685.  
  2686. What decides the quality of samples? (Software approach)
  2687.  
  2688. When sampling, it's essential that your equipment is in perfect order.
  2689. All connectors must be clean and your wires should be properly isolated.
  2690. If you experience a lot of interference, you could try to disconnect all
  2691. electrical appliances nearby.
  2692.  
  2693. Sample from the auxillery output of your Stereo rather than from the
  2694. headphones output. If your Stereo does not have an AUX output, try
  2695. sampling directly from the CD- or Cassette player.
  2696.  
  2697. The volume should be adjusted in a way that it just about fills the
  2698. entire height in the sample editor in ProTracker in order to utilise the
  2699. full sample-resolution.
  2700.  
  2701. When selecting sample rates, you should keep in mind that higher
  2702.  
  2703.                               - Page 38 -
  2704. 61.    Samples
  2705.  
  2706. sampling rates yields better quality but effectively eats up a lot of
  2707. memory. I myself samples most things at C-3 (16000 Hz) except drums,
  2708. which I sample at G-3 or A-3 (28000 Hz).
  2709.  
  2710. It doesn't matter (well, mostly) which sampling software you use, but I
  2711. prefer to use ProTracker since it's editing functions are faster than
  2712. any other I've seen.
  2713.  
  2714. 62.    Miscellaneous
  2715.  
  2716. Not much to say, these are... erm.. miscellaneous things!
  2717.  
  2718.         Chronicles and anecdotes
  2719.         Known bugs
  2720.         Things we'll never implement
  2721.         Things we will implement
  2722.         Frequently asked questions
  2723.         Contacting the authors
  2724.  
  2725. 63.    Chronicles and anecdotes
  2726.  
  2727. This chapter contains some historical and background information. Not
  2728. all  of this may be proper to put into a documentation, but I hope it's
  2729. interesting for someone.
  2730.  
  2731.         ProTracker development and progress
  2732.         ProTracker-relevant clones
  2733.         ProTracker version history
  2734.  
  2735. 64.    Development and progress
  2736.  
  2737. SOUNDTRACKER - THE BEGINNING OF A NEW ERA
  2738.  
  2739. Way back (dunno, the year) Karsten Obarski was tired of the monotonous
  2740. music in all games and demos and came up with the idea of using samples
  2741. for instruments in music. The music used at the time consisted either of
  2742. synthetic instruments or sampleloops. There were two mainreasons for
  2743. this. Firstly, people still wanted to support the first A1000 models
  2744. which came with 256KB RAM and secondly sampleloops were easier to make
  2745. (mostly grabbed from records).
  2746.  
  2747. Karsten Obarski's program, SoundTracker v1.0 didn't look much like
  2748. todays trackers, it had no sampleeditor, the patterns didn't scroll when
  2749. playing and one couldn't load modules (storage of music was based on
  2750. songs). The module/song-format was easy and fairly effective and is
  2751. still used in today's Trackers (though it has been expanded from 15 to
  2752. 31 instruments).
  2753.  
  2754. The SoundTracker became immediately extremely popular and everyone
  2755. started using it. The program was far easier to use than other programs
  2756. available at the time and various "crackers" started improving on the
  2757. program.
  2758.  
  2759.  
  2760. SOUNDTRACKER - THE CHAOS AND THE FALL
  2761.  
  2762. As several other groups started making their own versions of
  2763. SoundTracker, Karsten Obarski gave it up and didn't release more version
  2764. than v1.0. Groups such as The New Masters, D.O.C. and Spreadpoint seemed
  2765. to fight for doing the best improvements and this "race" caused a
  2766. significant improvement of SoundTracker. But after a while the groups
  2767. got tired of the work and couldn't compete with a new tracker-clone by
  2768. Mahoney and Kaktus of Northstar called NoiseTracker.
  2769.  
  2770.  
  2771. PROTRACKER ENTERS THE STAGE
  2772.  
  2773.  
  2774.                               - Page 39 -
  2775. 64.    Development and progress
  2776.  
  2777. Just before SoundTracker died, a small and (fairly) unknown norwegian
  2778. group called Amiga Freelancers started disassembling SoundTracker v2.4
  2779. in an attempt to improve it. NoiseTracker gained a lot of users before
  2780. ProTracker acctually got released. However, ProTracker contained so many
  2781. features that weren't in SoundTracker, that Mahoney and Kaktus gave up.
  2782.  
  2783. ProTracker shortly became the standard and noone even thought of using
  2784. other trackers.
  2785.  
  2786.  
  2787. AMIGA FREELANCERS GIVE UP
  2788.  
  2789. I late 1991, Amiga Freelancers got tired of updating the ProTracker and
  2790. decided to hand out the source to the public. At this time they had
  2791. recently released v1.2 and v2.0 (v2.0 was a semi-commercial version, but
  2792. the only differences from v1.2 was the opening-graphics). After a while,
  2793. they still released v1.3A and v1.3B with some bugfixes, but the sources
  2794. for these were never released.
  2795.  
  2796. At this time, a lot of quick hacks was released by several groups in an
  2797. attempt to win fame and fortune, but the only groups that did noticable
  2798. improvements was Noxious and Cryptoburners.
  2799.  
  2800.  
  2801. NOXIOUS TAKES OVER - FOR A WHILE
  2802.  
  2803. Noxious releases their first version (v2.1A) in the early 1992 but stops
  2804. after v2.3a in January 1993 probably as a result of Cryptoburners new
  2805. ProTracker, v3.0. In my humble opinion Noxious did pretty much for
  2806. ProTracker and a lot of people still uses v2.3a because they can't get
  2807. used to the new look introduced by Cryptoburners in v3.0.
  2808.  
  2809.  
  2810. CRYPTOBURNERS - RADICAL CHANGES
  2811.  
  2812. Cryptoburners changed the resolution of the ProTracker from  Low-Res to
  2813. Hi-Res, a change that has been discussed widely by ProTracker users.
  2814. They altered the positions of a lot of gadgets and some people still
  2815. haven't get used to it. Other changes by Cryptoburners included new
  2816. disk-operations screen and some more edit-gadgets.
  2817.  
  2818.  
  2819. MAW - 14 BIT SOUND
  2820.  
  2821. After ProTracker v3.10, Cryptoburners handed the source over to Maw who
  2822. was supposed to implement DYN sound (up to 14 bit sound resolution) in
  2823. ProTracker. According to Maw himself, no versions after v3.10 was
  2824. released as these were supposed to be beta-versions sent to different
  2825. people. Maw never fully completed the DYN implementation and has given
  2826. up the project and is now working on a new music-program he intend to
  2827. call ProTracker4. This program has more than 4 voices, synthetic sound
  2828. and works with 16-bit samples. Maw refuses to release his work on
  2829. ProTracker and his work is therefore lost forever. However, a lot of
  2830. people look at this as a nice thing anyway, since it is nearly
  2831. impossible to play 14-bit sound in an action-paced game and the
  2832. implementation of the DYN system mostly caused bugs.
  2833.  
  2834.  
  2835. CRYPTOBURNERS AGAIN - WHAT HAPPENED TO THEM?
  2836.  
  2837. As far as I know, Cryptoburners has stopped developing the ProTracker
  2838. and is currently working for FunCom productions, a manufacturer of video
  2839. games. If they still has the v3.10 source it would be the best point to
  2840. continue the ProTracker from, but the author haven't been able to reach
  2841. them yet.
  2842.  
  2843.  
  2844.  
  2845.                               - Page 40 -
  2846. 64.    Other tracker-clones
  2847.  
  2848.  
  2849. 65.    Other tracker-clones
  2850.  
  2851. All programs are listed in estimated time of arrival. 8)
  2852.  
  2853.  
  2854. SoundTracker v1.0
  2855.  
  2856. This is the mother of all tracker-clones and was made a looong time ago
  2857. (around the release of A500 methinks). The author is Karsten Obarski and
  2858. the program was (in my opinion) far from easy to use. After releasing
  2859. this, other groups released a lot of improvements on this program and
  2860. Karsten Obarski sort of gave up improving the program himself.
  2861.  
  2862.  
  2863. SoundTracker v1.1 - v2.3
  2864.  
  2865. These versions were different improvements over SoundTracker v1.0.
  2866. Unfortunately, I have no information on who made the different versions
  2867. (please write if you do). I do however, know that Dr. Mabuse of DOC and
  2868. T.I.P of The New Masters released most of these versions.
  2869.  
  2870.  
  2871. Games Music Creator
  2872.  
  2873. This music program looks a lot like the v2.x-soundtrackers and contains
  2874. a lot of the same features. However it seems recoded and a bit
  2875. unfinished. The author is Andreas Tadic.
  2876.  
  2877.  
  2878. SoundTracker Pro II
  2879.  
  2880. This tracker has a totally different look from the other tracker-clones.
  2881. It looks like it's supposed to have more features, but is far from
  2882. finished. Unfortunately, there is no text in the program that states who
  2883. made this program.
  2884.  
  2885.  
  2886.  
  2887. NoiseTracker v1.0 - v2.1
  2888.  
  2889. NoiseTracker made by Mahoney and Kaktus of Northstar was the first
  2890. tracker to implement 31 instruments and a configuration-screen! This
  2891. tracker became immediately very popular, and was probably the king of
  2892. the scene until ProTracker came along. The NoiseTracker was based on
  2893. SoundTracker v2.3
  2894.  
  2895.  
  2896. SoundTracker v2.4 - v2.5
  2897.  
  2898. These were SoundTrackers which adopted the new features of NoiseTracker,
  2899. including 31 instruments. According to my knowledge, both these versions
  2900. were made by MnemoTroN of Spreadpoint.
  2901.  
  2902.  
  2903. ProTracker
  2904.  
  2905. This is about the place where ProTracker first did it's appearance.
  2906. Beacuse of the many changes from SoundTracker (which it was based on),
  2907. there were numerous bugs in the first versions.
  2908.  
  2909.  
  2910. NoiseTracker v1.3D
  2911.  
  2912. I haven't the foggiest about who made this version of NoiseTracker, but
  2913. as far as I know, it wasn't Mahoney and Kaktus. This version utilised a
  2914. special "packed" moduleformat.
  2915.  
  2916.                               - Page 41 -
  2917. 65.    Other tracker-clones
  2918.  
  2919.  
  2920.  
  2921. SoundTracker v2.6
  2922.  
  2923. This SoundTracker implemented something no other tracker has ever used,
  2924. one-channel patterns. The idea is that for each position you have to
  2925. specify one pattern for each channel. This idea saves some memory, but
  2926. is harder to edit and did therefore not "win" the audience. This tracker
  2927. was also made by MnemoTroN.
  2928.  
  2929.  
  2930. StarTrekker v1.0 - v1.3
  2931.  
  2932. This tracker was the first to utilise more than 4 voices! It could play
  2933. a maximum of eight voices and included synthetic sounds. (AM and FM
  2934. sounds!) Unfortunately, this tracker died silently. StarTrekker was
  2935. based on NoiseTracker v2.0 and was made by Björn Wesen (aka Exolon of
  2936. Fairlight).
  2937.  
  2938.  
  2939. IceTracker v1.0 - v1.1
  2940.  
  2941. This tracker was based on SoundTracker v2.6 and was made by Isepic. It
  2942. consisted of several improvements and add-ons.
  2943.  
  2944.  
  2945. MaxTracker v1.0
  2946.  
  2947. This tracker was originally based on ProTracker v1.2, and included the
  2948. possibility to store samples in fast memory. The readme-file that  was
  2949. distributed with this tracker stated that it could play samples of any
  2950. length, but couldn't get it to load nor sample samples over 64 KB. The
  2951. author is Sylvain Marchand.
  2952.  
  2953. 66.    Version history
  2954.  
  2955. VERSION HISTORY
  2956.  
  2957. The version histories are listed by versionnumber, not by releasedate.
  2958.  
  2959. There is a version around marked V3.18 BETA with reworked setupscreen
  2960. and the dir-selector-bug fixed. Since this version is a true
  2961. beta-version (i.e: it is not supposed to be spread) it is not considered
  2962. a release nor listed separately here.
  2963.  
  2964. All versions of ProTracker is based on lower versions, except (ofcourse)
  2965. the V0.89 BETA, which is based on SoundTracker v2.5 by MnemoTroN.
  2966.  
  2967. If anyone has version-information for versions not listed here or
  2968. versions which has no specific information listed, feel free to
  2969. send them in.
  2970.  
  2971. Sources:
  2972.     Source for ProTracker V1.2 and V2.0
  2973.     Quick doc for PT V0.89 by Mad Martian
  2974.     ProTracker V1.0A readme-file
  2975.     ProTracker V1.0A readme-file
  2976.     ProTracker V1.3B readme-file
  2977.     ProTracker V2.3A readme-file
  2978.     ProTracker V3.00ß readme-file
  2979.     ProTracker V3.01 readme-file
  2980.     ProTracker V3.10 readme-file
  2981.     ProTracker V3.14B readme-file
  2982.  
  2983. Version releasenotes:
  2984.     V0.89 BETA          Amiga Freelancers
  2985.     V1.0A               Amiga Freelancers
  2986.  
  2987.                               - Page 42 -
  2988. 66.    Version history
  2989.  
  2990.     V1.0B               Amiga Freelancers
  2991.     V1.0C               Amiga Freelancers
  2992.     V1.1A               Amiga Freelancers
  2993.     V1.1B               Amiga Freelancers
  2994.     V1.2                Amiga Freelancers
  2995.     V1.2C               Raul Sobon
  2996.     V1.2D               Raul Sobon
  2997.     V1.2E               Raul Sobon
  2998.     V1.2F               Raul Sobon
  2999.     V1.3A               Amiga Freelancers
  3000.     V1.3B               Amiga Freelancers
  3001.     V1.8                SCL
  3002.     V2.0                Amiga Freelancers
  3003.     V2.1A               Mushroom Studios / Noxious
  3004.     V2.2A               Mushroom Studios / Noxious
  3005.     V2.3A               Mushroom Studios / Noxious
  3006.     V3.00 BETA          Cryptoburners
  3007.     V3.01               Cryptoburners
  3008.     V3.10 BETA          Cryptoburners
  3009.     V3.14B              Cryptoburners
  3010.     V3.15               Cryptoburners
  3011.  
  3012. 67.    V0.89 BETA
  3013.  
  3014. V0.89 BETA (May 1990) - Exclusively for Crusaders
  3015.  
  3016. This is the first known release of ProTracker. It was based on
  3017. SoundTracker V2.5 by MnemoTroN and made by The Amiga Freelancers.
  3018.  
  3019. * Retrig note, note delay, pattern delay and funk repeat didn't work.
  3020.  
  3021. * Finetune were introduced.
  3022.  
  3023. * Online help. =)
  3024.  
  3025. 68.    V1.0A
  3026.  
  3027. V1.0A (August 1990) - First public release
  3028.  
  3029. Many functions not operational in V0.89 were now implemented.
  3030.  
  3031. 69.    V1.0B
  3032.  
  3033. V1.0B (September 1990) - Bugfix
  3034.  
  3035. * PatternLoop (It always jumped to the start of the pattern, not the
  3036. loop)
  3037.  
  3038. * FineTune AND Glissando-Control were in the same command! (E3)
  3039.  
  3040. * Fade Up / Down caused shit and even a few gurus!
  3041.  
  3042. * Delete Pos inserted pattern 77 (!) at position 127 in the song,
  3043. causing it to be longer than 80k!
  3044.  
  3045. * Filter All Samples was slow as hell because it tried to filter
  3046. nonexistant samples.
  3047.  
  3048. * If you selected sample 0 from the keypad, it always played the last
  3049. sample played as sample 0!
  3050.  
  3051. * A590 harddisk owners couldn't use the keyboard because of the way
  3052. Mahoney & Kaktus set up the keyboard interrupt (their NT1.1 routine was
  3053. used).
  3054.  
  3055. * Entering the help screen when in the midi screen fucked up the
  3056. display.
  3057.  
  3058.                               - Page 43 -
  3059. 69.    V1.0B
  3060.  
  3061.  
  3062. * Escaping from Mix exited from the whole edit op.!
  3063.  
  3064. * CutBeg no longer fucks up the Sample length and Pos.
  3065.  
  3066. * The help file was FULL of bugs / misspellings.
  3067.  
  3068. 70.    V1.0C
  3069.  
  3070. V1.0C (October 1990) - Bugfix
  3071.  
  3072. * Error in Finetune-table2 (note B-2)
  3073.  
  3074. * Abort Load sometimes caused a guru!
  3075.  
  3076. * Toneportamento (cmd 3) didn't work correctly with finetune.
  3077.  
  3078. * PLST screen was one pixel off.
  3079.  
  3080. * MIDI screen was removed.
  3081.  
  3082. 71.    V1.1A
  3083.  
  3084. V1.1A (December 1990) - Party release with bugs
  3085.  
  3086. * Read input in a more system-friendly way.
  3087.  
  3088. * Detached from CLI.
  3089.  
  3090. * Loaded IFF samples correctly.
  3091.  
  3092. * Used sprites to show loop in sampler.
  3093.  
  3094. * Several directory paths in disk operations screen.
  3095.  
  3096. * Protracker will now run if you have Kickstart 2.0 installed! (A500,
  3097. A1000, A2000, A3000 etc...)
  3098.  
  3099. * Keyboard buffer. Wow!!! Now you can play really fast, and PT won't
  3100. miss a single key (...well, not as many as it used to before...).
  3101.  
  3102. * The vertical blank interrupt no longer patches the vector itself, but
  3103. uses the AddIntServer function.
  3104.  
  3105. * The playroutine creates it's own CIA or VBLANK interrupt, and it will
  3106. not be removed if a song is playing when you go to CLI/Workbench.
  3107.  
  3108. * Improved "Out of memory" handling (hopefully no more gurus...).
  3109.  
  3110. * Only the first 2 bytes of a sample will be zeroed (were the first 4).
  3111.  
  3112. * Lots of new keyboard commands/shortcuts using the Alt key.
  3113.  
  3114. * Vibrato depth changed to be compatible with NT2.0.
  3115.  
  3116. * Funk Repeat changed to Invert Loop (may trash your samples though).
  3117.  
  3118. * Play samples from the keypad (dot mode) when pressing backslash.
  3119.  
  3120. * Quadrascope. Four channel oscilloscope that displays the samples in
  3121. real- time, even when playing from keyboard. The good old spectrum
  3122. analyzer is still there, just click on the scope to toggle.
  3123.  
  3124. * Tempo gadget. Default is 125 BPM (normal vblank speed), but that can
  3125. be changed if you select CIA timing on Setup2. Range is 32-255 BPM, and
  3126. can also be changed with the 'F' effect command (speed/tempo).
  3127.  
  3128.  
  3129.                               - Page 44 -
  3130. 71.    V1.1A
  3131.  
  3132. * Repeat and replen will be updated in the samples when you change them.
  3133. You no longer have to press a key to hear the new loop.
  3134.  
  3135. * Protracker should now be able to show up to 10/16 megs of freemem.
  3136.  
  3137. * Error messages when PLST or Config not found.
  3138.  
  3139. * Click to enter position, pattern and length with the keyboard.
  3140.  
  3141. * Choose RAW or IFF when saving samples.
  3142.  
  3143. * Samples can be saved with IFF-loops.
  3144.  
  3145. * Change path without reading directory.
  3146.  
  3147. * All 30 characters in filename/directory stored (was 24).
  3148.  
  3149. * Shows directories, just click to add directory to path.
  3150.  
  3151. * Parent directory gadget.
  3152.  
  3153. * One preset and several default paths for modules/songs/samples.
  3154.  
  3155. * PT will now read an "unlimited" number of directory entries (was
  3156. 200).
  3157.  
  3158. * Two setup-screens.
  3159.  
  3160. * Override: Load/save sample from samplepath even if there's a path in
  3161. the samplename. ST-37:bigbadbass with override will be loaded from DF0:
  3162. (or whatever) instead of ST-37:. You may want to put all your samples in
  3163. one big directory on your harddisk...
  3164.  
  3165. * NoSamples: Will load a song without asking for the samples.
  3166.  
  3167. * BlankZero: This will show the samplenumbers in the pattern in the same
  3168. way as Noisetracker 1.2 (Zeros are blanked out).
  3169.  
  3170. * Show Dirs: If on, directories will be shown in Disk Op.
  3171.  
  3172. * Show Publ: If on, PT will show all free Public memory, otherwise just
  3173. free Chip memory.
  3174.  
  3175. * CutToBuff: If on, the part of the sample cut away in the sample editor
  3176. will be saved in the copybuffer.
  3177.  
  3178. * Load Loop: Will load loops from an IFF file when loading a sample, or
  3179. adding a path in the sampleeditor.
  3180.  
  3181. * Slow Mode: Use this toggle if you have a 25 Mhz A3000 where everything
  3182. is faster. Turning it on might help.
  3183.  
  3184. * Set Default paths.
  3185.  
  3186. * You can set the maximum number of presets (used to be 2500).
  3187.  
  3188. * DMA wait. Use this on 25MHz Amigas (normally 300, use 900 on A3000).
  3189.  
  3190. * Set tuning tone (note and volume).
  3191.  
  3192. * Select CIA or VBlank timing.
  3193.  
  3194. * Set default CIA tempo.
  3195.  
  3196. * Spectrum Analyzer/VU-meter copper color editor!
  3197.  
  3198. * Use Preset removed, inserted Delete Disk instead.
  3199.  
  3200.                               - Page 45 -
  3201. 71.    V1.1A
  3202.  
  3203.  
  3204. * You can now save Finetune instead of Volume in the PLST.
  3205.  
  3206. * ST-disk number changed to hex (ST-00 --> ST-FF)!
  3207.  
  3208. * Adding samples with IFF-loops to the presetlist is possible.
  3209.  
  3210. * Proper PLST allocation. Protracker will no longer allocate any memory
  3211. if there's no PLST.
  3212.  
  3213. * ST-disk number changed to HEX. This means you can have up to $FF, or
  3214. 255 ST-disks (used to be 99).
  3215.  
  3216. * Sample Graphing like Audiomaster. With Show Range, Show All, Zoom Out,
  3217. Range All, etc...
  3218.  
  3219. * Play either Waveform, Display or Range.
  3220.  
  3221. * Repeat points are shown, and can be dragged around.
  3222.  
  3223. * Loop on/off toggle.
  3224.  
  3225. * A line shows current position when playing back a sample.
  3226.  
  3227. * A sampler just like on NT2.0.
  3228.  
  3229. * Resample function w/tuning tone.
  3230.  
  3231. * Cut, Copy and Paste functions.
  3232.  
  3233. * Cursor to beginning/end.
  3234.  
  3235. * Swap current sample with copybuffer.
  3236.  
  3237. * Transpose All bug removed.
  3238.  
  3239. * Move changed to Copy (use this to copy samples too).
  3240.  
  3241. * Upsample changed a tiny bit (allocation).
  3242.  
  3243. * Most functions will now work with marked ranges.
  3244.  
  3245. 72.    V1.1B
  3246.  
  3247. V1.1B (August 1991) - Most known version. (Methinks =)
  3248.  
  3249. * Many major bugfixes.
  3250.  
  3251. * Changed layout for quadrascope.
  3252.  
  3253. * Load gadget no longer hangs the program when trying to load a file
  3254. that doesn't exist.
  3255.  
  3256. * Better filehandling with error messages.
  3257.  
  3258. * Repeat and replen check installed (Rel. A hanged when replen
  3259. accidentally got the value zero).
  3260.  
  3261. * Repeat and replen were swapped when loading an IFF sample.
  3262.  
  3263. * Only RepLen values in IFF samples were added in the preset-editor.
  3264.  
  3265. * Tune memory wasn't always updated when editing samples.
  3266.  
  3267. * Swap Buffer debugged.
  3268.  
  3269. * The arpeggio sounded weird because the pitch wasn't set back at the
  3270.  
  3271.                               - Page 46 -
  3272. 72.    V1.1B
  3273.  
  3274. right time.
  3275.  
  3276. * Shift speeds up the scrolling in the PLST and preset-editor.
  3277.  
  3278. 73.    V1.2
  3279.  
  3280. V1.2 (July 1991?) - Kickstart V2.0 version
  3281.  
  3282. Information could not be obtained.
  3283.  
  3284. 74.    V1.2C
  3285.  
  3286. V1.2C (July 1991?) - Parallel communication version
  3287.  
  3288. Made by Raul Sobon. He did also make V1.2D, V1.2E and V1.2F.
  3289.  
  3290. * Made real 8 channels possible through parallel communication between
  3291. two Amigas.
  3292.  
  3293. 75.    V1.3B
  3294.  
  3295. V1.3B (Unknown release date)
  3296.  
  3297. V1.3A was also accidentally released, but contained many bugs.
  3298.  
  3299. * Save module bugfix.
  3300.  
  3301. * Not case sensitive on 'MOD.'
  3302.  
  3303. * 'MOD.' bug when switching to and from modules dir.
  3304.  
  3305. * Inputhandler bugs fixed.
  3306.  
  3307. * Single Step forward and backward works properly.
  3308.  
  3309. * The Sample function works with OS2.0
  3310.  
  3311. * No hang when a R/W-error occurs in OS2.0
  3312.  
  3313. * No crash when loading a non-module file.
  3314.  
  3315. * MIDI In works as it should!!!
  3316.  
  3317. * PT on Pseudo system screen (?)
  3318.  
  3319. * [LEFT Amiga] M and [LEFT Amiga] N works within ProTracker.
  3320.  
  3321. * Improved multitasking!
  3322.  
  3323. * Screen Adjust (for A3000).
  3324.  
  3325. * No slowmode necessary for turbo Amigas. Auto init of DMAWait.
  3326.  
  3327. * System requesters ON/OFF function.
  3328.  
  3329. * Finds volumes and diskdrives in filerequester.
  3330.  
  3331. 76.    V1.8
  3332.  
  3333. V1.8 (1994?) - Parallel communication version
  3334.  
  3335. Made by Bagitman of SCL.
  3336.  
  3337. * Made real 8 channels possible through parallel communication between
  3338. two Amigas.
  3339.  
  3340.  
  3341.  
  3342.                               - Page 47 -
  3343. 76.    V2.0
  3344.  
  3345.  
  3346. 77.    V2.0
  3347.  
  3348. V2.0 (Unknown release date)
  3349.  
  3350. Mainly the same as V1.2. I don't think anyone knew the difference. =O
  3351.  
  3352. 78.    V2.1A
  3353.  
  3354. V2.1A (Unknown release date)
  3355.  
  3356. Made by Mushroom Studios/Noxious. Contained many Bugs.
  3357.  
  3358. * mod. prefix was shown in the file-list if it wasn't lowercase only.
  3359.  
  3360. * ReturnfromCLI requester enhanced with quitgadget.
  3361.  
  3362. * Gadgetpositions fixed properly.
  3363.  
  3364. * Accidental and Diskspace bugs fixed.
  3365.  
  3366. * Editskip has now got an indicator.
  3367.  
  3368. * DISK OP., PLST and PRESET-ED screens have TOP/BOTTOM gadgets.
  3369.  
  3370. * PLST screen has now got Up/Down arrows.
  3371.  
  3372. * PT can load&save powerpacked samples/modules.
  3373.  
  3374. * PT can load&save tracks/patterns.
  3375.  
  3376. * Format disk bug has been fixed (I hope).
  3377.  
  3378. * Volume,Repeat,Replen,Pos & Mod is now editable from the keyboard. Just
  3379. click on the numbergadgets.
  3380.  
  3381. * You can now choose an autoinserteffect of your own. (One of the ten
  3382. effectmacros).
  3383.  
  3384. * The bug that completely turned the sound off when stopping the
  3385. recording has now been fixed.
  3386.  
  3387. * You are now able to fastscroll the file- and presetlist to the next
  3388. startcharacter.
  3389.  
  3390. * The preset-ed routines have been corrected.To use your old PLST,
  3391. simply delete preset #0.
  3392.  
  3393. * The metronome has now got an accent on the first beat.
  3394.  
  3395. * A metronome keyboard toggle has been included.
  3396.  
  3397. * The metronomechannel can easily be changed to the current
  3398. cursorposition.
  3399.  
  3400. * Most of the numbergadgets can now be zero'ed.
  3401.  
  3402. * Better patternrefresh when doing keyboard I/O.
  3403.  
  3404. * PT now reads the dir after rename/save/delete if the Autodirtoggle is
  3405. on.
  3406.  
  3407. * You can solo a channel with the mouse by holding the right mousebutton
  3408. while pressing 1,2,3 or 4.
  3409.  
  3410. * You can pass an argument from workbench/shell/cli to automatically
  3411. load a module when PT starts.
  3412.  
  3413.                               - Page 48 -
  3414. 78.    V2.1A
  3415.  
  3416.  
  3417. * Powerpacker crunching/decrunching with powerpacker.library! PT will
  3418. automaticly append/remove ".pp" to/from the filename.
  3419.  
  3420. * You can save an Icon together with the module.
  3421.  
  3422. 79.    V2.2A
  3423.  
  3424. V2.2A (Unknown release date)
  3425.  
  3426. * Fixed the chip-mem bug from PT2.1A. (It didn't work with chipmem
  3427. only)
  3428.  
  3429. * When Preset-ed screen was shown,you couldn't use the gadgets on the
  3430. lower part of the main- or sample-screen.
  3431.  
  3432. * When autoexitdirtoggle was off,PT didn't change the songname when you
  3433. loaded a new song/module until you exit from disk op.
  3434.  
  3435. * If you resampled a sample with big difference between the tunetone and
  3436. the resampletone then the new length was incorrectly computed.
  3437.  
  3438. * If you ran out of memory when allocating crunchbuffersize then ...
  3439. software failure! This should work just fine now.
  3440.  
  3441. * If you loaded a sample with a '.' in the samplename then PT set the
  3442. length incorrectly in some cases.
  3443.  
  3444. * Save module should work fine now.(another nasty bug is swept away!)
  3445.  
  3446. * The Sampler works fine on ks2.0 (This version tests diskactivity
  3447. before sampling, PT1.3 doesn't!) Source by Matrix/LSD.
  3448.  
  3449. * The timer is updated when you play a song while jumping out to
  3450. Workbench.
  3451.  
  3452. * The Loopsprites are working fine with screenadjust.
  3453.  
  3454. * Stepplay works fine now. Amiga+Backspace is gone though.
  3455.  
  3456. * MIDI in functions are working now, I hope!
  3457.  
  3458. * Inputhandler debugged a little.
  3459.  
  3460. * ShowFreeDiskGadget debugged (again). Before it showed 2 sectors too
  3461. much.
  3462.  
  3463. * If you pressed the deletefile gadget and then pressed a directoryname
  3464. in the list then the dir was added to the path but the directory wasn't
  3465. opened. This is now fixed.
  3466.  
  3467. * PrintSong now prints the patternlist with decimal values. It prints
  3468. all patterns.(Older versions of PT missed to print the highest pattern)
  3469.  
  3470. * I have implemented a chord maker.
  3471.  
  3472. * I have implemented e Position-Editor.
  3473.  
  3474. * On request, I have made ''multitasking'' like in PT1.3.
  3475.  
  3476. * ProTracker has it's own screen. When the PT screen is in front of all
  3477. other screens, PT will wake up.
  3478.  
  3479. * The browse function is modified to act like PT1.3. It shows the
  3480. current devices and disknames.
  3481.  
  3482. * If you hold the right mousebutton while pressing the browsegadget a
  3483.  
  3484.                               - Page 49 -
  3485. 79.    V2.2A
  3486.  
  3487. disklist will pop up showing all the device- and disknames from the
  3488. browsegadget in the filenamewindow. Pressing a name will autoload that
  3489. directory.
  3490.  
  3491. * If you press LeftShift+any key 0-9 a-z while in DiskOp,  PLST or
  3492. PresetEd, PT will move you to the position in the list with a name
  3493. beginning with the corresponding character.
  3494.  
  3495. * If you use MIDI I've added two new keys. A-2 and B-2 on the
  3496. Synthkeyboard are used as SampleNumber Up/Down! I have also Transposed
  3497. the MIDInotes input one octave down (because Dolphin has a small
  3498. keyboard and couldn't access the upper octave,C#3 - B-3).
  3499.  
  3500. * SaveExecutable option.
  3501.  
  3502. * 9 new toggles.
  3503.  
  3504. 80.    V2.3A
  3505.  
  3506. V2.3A (January 1993)
  3507.  
  3508. * Mountlist in PLST is fixed. Before it asked for disks in all drives
  3509. even if you didn't have extradrives.
  3510.  
  3511. * Helpfile fixed. In the betaversion the jumptable was corrupt.
  3512.  
  3513. * Pointer color was green after succesful saving. This one is fixed
  3514. now.
  3515.  
  3516. * In the betaversion you couldn't exit POS-ed with ESC.
  3517.  
  3518. * PT shouldn't quit with ESC. This is fixed now. Use Alt+Q (This one has
  3519. been there all the time) or click in the top-left corner to quit.
  3520.  
  3521. * There was a bug in the Entry jump routine (Shift+Desired character) in
  3522. Disk.op, PLST and PresetED. If you had directories in the current path
  3523. PT jumped to the first DIRECTORY starting with the desired character
  3524. instead of searching for the first FILE beginning with that character.
  3525.  
  3526. * Some minor bugs fixed as well.
  3527.  
  3528. 81.    V3.00 BETA
  3529.  
  3530. V3.00 BETA (January 1993) - Hires version
  3531.  
  3532. Made by Cryptoburners, and based upon V1.3, and does therefore not
  3533. contain the features of V2.1A - V2.3A.
  3534.  
  3535. * PowerPacker support. Powerpacker.library must be present in the
  3536. "sys:libs/" directory. Version needed: 35.000 or higher. It is however
  3537. recommended that you have at least 1MB to use this feature with large
  3538. modules.
  3539.  
  3540. * Protracker rearranged to HIRES 640x256x3.
  3541.  
  3542. * Format now works with dfx. Remember to specify which drive to format
  3543. in the "path" string-gadget.
  3544.  
  3545. * Midi has been kicked out (temporarily?).
  3546.  
  3547. * "SpectrumAnalyzer" has been kicked out.
  3548.  
  3549. * Protracker now works on Kickstart 2.04 and higher (SCS/ECS).
  3550.  
  3551. * Memory display now displays all memorytypes.
  3552.  
  3553. * Improved input handler. PT will now live peacefully with Commodities.
  3554.  
  3555.                               - Page 50 -
  3556. 81.    V3.00 BETA
  3557.  
  3558. We hope.
  3559.  
  3560. * Invented new fileformat based on Interchanged File Format (IFF)
  3561. chunks. See docs elsewhere on this disk for a discussion of this
  3562. format.
  3563.  
  3564. * Hold record mode; waits for keypress before starting to record.
  3565.  
  3566. * New filerequester.
  3567.  
  3568. * Screen to back gadgets. You may also use Left Amiga + M/N.
  3569.  
  3570. * Standalone playroutine supporting Finetune etc. Not fast though :(
  3571.  
  3572. * Some speedups in the SampleEd. It was awfully slow at marking in
  3573. HIRES!
  3574.  
  3575. * Scroll bars added here and there (but not everywhere ;)
  3576.  
  3577. * New pointer! The old one was simply too big for the new resolution..
  3578. :)
  3579.  
  3580. * Setupscreen revised and merged into one.
  3581.  
  3582. * Date and time online at mainscreen.
  3583.  
  3584. * Task interferance problems fixed (Improved multitasking). No busy
  3585. waits.
  3586.  
  3587. * The dragging routine in the sampler draws pixels instead of lines when
  3588. dragging.
  3589.  
  3590. * Major rearranging on mainscreen; editor centered and some new buttons
  3591. for editing, such as cut/paste, up/down octave etc.
  3592.  
  3593. * You may now click into the different tracks with the left mousebutton!
  3594. :o
  3595.  
  3596. * Audio.device channel allocation, to ensure that other programs doesn't
  3597. mess with your tunes in a multitasking environment.
  3598.  
  3599. * Chords editor with up to 7 notes. (Hi JanneS :)
  3600.  
  3601. * PT now hopefully works on KS3.0 in AGA mode too (Hi Vishnu).
  3602.  
  3603. * The sampler works again! ;)
  3604.  
  3605. 82.    V3.01
  3606.  
  3607. V3.01 (Unknown release date) - AM/FM release
  3608.  
  3609. * Reads the devices mounted in the system instead of hardcoded ones.
  3610.  
  3611. * "Free" gadget fixed.
  3612.  
  3613. * Sample read/write fixed.
  3614.  
  3615. * Now gets the directory automagically when one is entered in the
  3616. pathgadget.
  3617.  
  3618. * Fixed bug in chord editor. Sometimes caused division by zero.
  3619.  
  3620. * Added adjust to chord editor; boosts the volume of the resulting
  3621. sample to fit the original sample.
  3622.  
  3623. * Screen adjust gadget is now working. :)
  3624.  
  3625.  
  3626.                               - Page 51 -
  3627. 82.    V3.01
  3628.  
  3629. * Bug in runback fixed.
  3630.  
  3631. * CIA allocation failures are now displayed.
  3632.  
  3633. * Tools gadget removed.
  3634.  
  3635. * Short keys for setup-items caused the switches to be displayed on the
  3636. main screen. Not anymore :)
  3637.  
  3638. * Drumpad likewise.
  3639.  
  3640. * Several smaller bugs fixed.
  3641.  
  3642. * Added a gadget on the dirscreen for fast browsing through the file
  3643. type options.
  3644.  
  3645. * New icon on the out-of-memory requesters :o
  3646.  
  3647. * Some new gadgets are working!
  3648.  
  3649. * Minor graphical changes
  3650.  
  3651. * Decimal numbers on samplelength and loops
  3652.  
  3653. 83.    V3.10 BETA
  3654.  
  3655. V3.10 BETA (May 1993) - Amiga Format version
  3656.  
  3657. * A new improved 7-note chord editor, recalculates loops.
  3658.  
  3659. * Full compatibility with all existing OS versions including OS3.0
  3660.  
  3661. * Better multitasking capabilities.
  3662.  
  3663. * New sample edit options, includes Invert, Maximize, NormalDC,
  3664. Normalize.
  3665.  
  3666. * Mouse controlled editing made possible.
  3667.  
  3668. * Added real VU-meters.
  3669.  
  3670. * New configurable options:
  3671.         - Screen positioning.
  3672.         - Lace on/off for genlock users.
  3673.         - Multicached disk directories.
  3674.  
  3675. 84.    V3.14B
  3676.  
  3677. V3.14B (Unknown release date) - DYN samples version
  3678.  
  3679. * For the first time in Amiga history: Improved sound quality! Actual 14
  3680. bit sound dynamics using a new and revolutionary algorithm. No
  3681. additional add-ons required, furthermore, no extra storage usage. Fully
  3682. compatible with traditional 8-bit Amiga sounds.
  3683.  
  3684. * Reads and converts Maestro MONO 16-bit samples.
  3685.  
  3686. * Info requester when reading IFF samples.
  3687.  
  3688. * The "BlankZero" now also blanks empty effect commands and the extended
  3689. command byte.
  3690.  
  3691. 85.    V3.15
  3692.  
  3693. V3.15 (Unknown release date) - Bugfix version
  3694.  
  3695.  
  3696.  
  3697.                               - Page 52 -
  3698. 85.    Known bugs
  3699.  
  3700.  
  3701. 86.    Known bugs
  3702.  
  3703. If your copy of ProTracker shows some strange behaviour and you can't
  3704. find it here, look in the Frequently Asked Questions section. It could
  3705. be that it's not really a bug. If you can't find your case anywhere,
  3706. please do contact the authors.
  3707.  
  3708. * On A1200/A600 it is not possible selecting (or atleast very difficult)
  3709. to select instrument $10-$1F using the keypad. This is our punishment
  3710. for not using the system and may not be fixed for a while. 8(
  3711.  
  3712. * ProTracker does not go on well with the debugging tool MungWall from
  3713. Commodore. Temporary workaround is to quit MungWall before running
  3714. ProTracker.
  3715.  
  3716. * Very few screenblankers cooperate with ProTracker. If ProTracker locks
  3717. up after 2-3 minutes, this could be it. Disable all screenblankers
  3718. before running ProTracker. (SuperDark does work though!)
  3719.  
  3720. * If you are using a hires-pointer on your Workbench, some gadgets, the
  3721. pointer and the cursor will appear with half width.
  3722.  
  3723. * On really fast machines (68030 30MHz or faster) some notes causes crap
  3724. in the audiospeakers. This will (hopefully) soon be fixed.
  3725.  
  3726. * When entering subdirectories in disk operations, some lines remain
  3727. "selected". This is taken care of.
  3728.  
  3729. * Earlier, you could change instrument-number without setting new notes,
  3730. and chip-instruments (very short samples with loop) would automatically
  3731. jump to the new sample. This no longer works after the implementation of
  3732. DYN samples.
  3733.  
  3734. * Playing the same note on two different channels may produce slightly
  3735. different sound from time to time.
  3736.  
  3737. * When editing the modulename from disk-operations, the first character
  3738. of the name of instrument 1 is set to a "_".
  3739.  
  3740. * Effect-command 9 (sample offset) doesn't give any sound if the desired
  3741. offset is behind the end of the sample. Earlier, it did.
  3742.  
  3743. * If ProTracker attempts to play a sample with 0 in replen (this is the
  3744. case of some older modules) it will lock up.
  3745.  
  3746. * Memory fragmentation occurs when starting PT twice from Icon.
  3747.  
  3748. * Samples succeeding 32Kb are not displayed fully in the sample editor.
  3749.  
  3750. * Keyrepeat sometimes don't stop in pattern editor. (Nasty!)
  3751.  
  3752. * Saving samples sometimes chooses the wrong device to write to.
  3753.  
  3754. * Turning off audio channels doesn't stop repeating instruments
  3755. immediately.
  3756.  
  3757. * Updating sample length when resampling/upsampling/downsampling.
  3758.  
  3759. * At present time you must launch PT as a project icon from WorkBench,
  3760. or from CLI. Tool icons will _hang_ your system!
  3761.  
  3762. * Applications that do not allocate the timers properly, will cause the
  3763. music to stop (eg. ProPlay). However, this is _not_ ProTrackers fault;
  3764. PT allocates the used timers gently :) As you see this is not really a
  3765. bug, but we just want kill potential "bug reports" in birth ;)
  3766.  
  3767.  
  3768.                               - Page 53 -
  3769. 86.    Known bugs
  3770.  
  3771. * When a DYN-sample is played by keys while song is playing, it will
  3772. sound distorted.
  3773.  
  3774. * If starting a song, notes with DYN-samples in the first line are not
  3775. always played correctly.
  3776.  
  3777. * Sample edit operations on DYN-samples will not work, but crash the
  3778. system (sooner or later).
  3779.  
  3780. * Using volume on DYN-samples creates awful distorted sounds.
  3781.  
  3782. * When loading a new module, ProTracker doesn't set the lo-pass filter
  3783. to the default value.
  3784.  
  3785. * When clicking on the destination-gadget in the chords-edit, PT seems
  3786. to select a random sample-number. This is ofcourse wrong.
  3787.  
  3788. * When mixing samples, PT does not calculate the arpeggio-values to put
  3789. in the samplename correctly if these are too high.
  3790.  
  3791. * Writing values directly to sample length/repeat/replen does not always
  3792. work.
  3793.  
  3794. * Increasing sample-length using the up arrow is okay, but decreasing
  3795. does not seem to work as desired.
  3796.  
  3797. * The playtime-clock is halted when the Workbench screen is up.
  3798.  
  3799. 87.    Things we'll never implement
  3800.  
  3801. * Splitting up each track of a pattern into a seperate "pattern",
  3802. independent of the others. After having talked to many musicians, we all
  3803. agreed this is all in vain. Nobody seems to be going to use it, due to
  3804. the serious timing problems that will arise. Use SIDMON instead, if
  3805. you're really anxious to use this feature ;)
  3806.  
  3807. * 8 channels Protracker. The Amiga is designed for 4 voices, if this
  3808. feature is to be implemented, the CPU has to mix the channels realtime,
  3809. and will use all CPU DMA on lowend Amigas. Forget it. Use StarTrekker if
  3810. you want it.
  3811.  
  3812. * Intuition Protracker (using the system for creating the
  3813. user-interface). Too much work :) maybe some sunny day...
  3814.  
  3815. 88.    Things we will implement
  3816.  
  3817. * Implementation of the new IFF fileformat :) which includes:
  3818.   - Commands ranging from 0..0xFF (0..255). All commands that CAN run
  3819.     in parallel will do. Lotsa other commands (hi JanneS :).
  3820.   - 256 Positions.
  3821.   - 256 Patterns.
  3822.   - 256 Samples. (Higly wanted!)
  3823.   - Implement octave 0!
  3824.   - Maximum sample size from 64Kb to 128Kb. It's there, why not use it?
  3825.  
  3826. * Digital filters and noise-reduction in the Sampler. Planned filters
  3827. include Lowpass, Highpass and Bandpass (FIR filters). Perhaps Graphic
  3828. Equalizer too.
  3829.  
  3830. * Seek zero/loop in sampler.
  3831.  
  3832. * Protracker.library for non-tech programmers wanting to use PT modules
  3833. in their programs.
  3834.  
  3835. * Separate position-editor.
  3836.  
  3837. * Save module as executable.
  3838.  
  3839.                               - Page 54 -
  3840. 88.    Things we will implement
  3841.  
  3842.  
  3843. * Add icon to saved files.
  3844.  
  3845. * Load samples/instruments/patterns from an existing module.
  3846.  
  3847. * Freehand sample-editing.
  3848.  
  3849. * ASDR editor for channel modulation.
  3850.  
  3851. * Gain/Finished info when (Power)Packing.
  3852.  
  3853. * Hypertext on-line help (a la Windows).
  3854.  
  3855. * Serial comm. to other protrackers. (Synchronize playing)
  3856.  
  3857. * A whole new range of DSP effects for your samples, including:
  3858.   - Low, high, band and allpass filters (IIR filters).
  3859.   - Comb filters.
  3860.   - Shelving low and high filters.
  3861.   - Multitap delay/feedback algorithms.
  3862.  
  3863. * Bugfree functionality. (This one has low priority!) =)
  3864.  
  3865. * Read (and save?) QuadraComposer (EMOD) modules.
  3866.  
  3867. 89.    Frequently asked questions
  3868.  
  3869. If you have any questions that's not listed here, send them in.
  3870.  
  3871.  
  3872.  
  3873. Q: Keyboard shortcuts with more than one key involved doesn't work as
  3874. expected. I have an A1200 or A600.
  3875.  
  3876. A: This is a known bug, and it's not much to do about it.
  3877.  
  3878.  
  3879. Q: When I run the program xxx before starting ProTracker, my Amiga
  3880. crashes.
  3881.  
  3882. A: Don't run xxx.
  3883.  
  3884.  
  3885. Q: When I launch ProTracker it always locks up after x minutes.
  3886.  
  3887. A: You have a screenblanker running. Quit it before launching
  3888. ProTracker.
  3889.  
  3890.  
  3891. Q: I use the resample-function in the sampler, but the resulting sample
  3892. is one or two octaves too high!
  3893.  
  3894. A: Your tunetone setting is not C-3. ProTracker takes the tunetone
  3895. setting into account when resampling.
  3896.  
  3897.  
  3898. Q: Some of my chipmodules sounded strange on my new ProTracker.
  3899.  
  3900. A: Some chip-modules rely on ProTracker changing the sample when setting
  3901. a new samplenumber for a channel without specifying a new note. This
  3902. worked earlier, but doesn't any longer.
  3903.  
  3904.  
  3905. Q: Sometimes instrument 1 gets the first character of it's named
  3906. replaced with a "_". Why?
  3907.  
  3908. A: This happens when editing the modulename from disk operations and is
  3909.  
  3910.                               - Page 55 -
  3911. 89.    Frequently asked questions
  3912.  
  3913. a bug. Sorry.
  3914.  
  3915.  
  3916. Q: I've got a module which my player regocnises as a ProTracker module,
  3917. but ProTracker refuses to load it in (or crashes). Why?
  3918.  
  3919. A1: The module utilises more than 64 patterns. These modules are created
  3920. with ProTracker V2.1 - 2.3 by Noxious. It's not much to do about this
  3921. until we've included support for these modules.
  3922.  
  3923. A2: The module is severly damaged. Try to repair it using the
  3924. TrackerTool command from DOS.
  3925.  
  3926. A3: The module is packed with some bogus packer that ProTracker doesn't
  3927. support. See the documentation for the player to find out which packer
  3928. and get the packer to unpack the module.
  3929.  
  3930.  
  3931. Q: I've got a module which makes the sample-display look phoney and
  3932. distorts the length-display in the sample-editor. Why?
  3933.  
  3934. A: Your module has samples longer than 65536 bytes. ProTracker does not
  3935. support this at current.
  3936.  
  3937.  
  3938. Q: I've got a module which gives a very high peeping sound at the end of
  3939. some samples. Why?
  3940.  
  3941. A: This module is either made on another platform (PC, Macintosh) or
  3942. converted from some old module-formats. The trick is that ProTracker
  3943. needs the 2 first bytes of each sample to be set to 0. This could either
  3944. be done by zooming in, selecting the first 2 bytes and setting their
  3945. volume to 0 or by cutting one byte at the end of the sample (this last
  3946. action causes ProTracker to automatically reset the first two bytes).
  3947.  
  3948.  
  3949. Q: I've got a module which makes ProTracker lock up when I attempt to
  3950. play it. Why?
  3951.  
  3952. A: Your module probably contains samples with replen set to 0. Set all
  3953. of these to 2 and your module should be fine.
  3954.  
  3955. 90.    Thanks and acknowledgements
  3956.  
  3957. The authors would like to thank and bring their acknowledgements out
  3958. to:
  3959.  
  3960. Lizard, all the guys at #amiga and #amigascne.
  3961.  
  3962. 91.    Contacting the authors
  3963.  
  3964. Contact one of the authors if you have bugreports or any other
  3965. suggestions.
  3966.  
  3967. NOTE: There is no use contacting Cryptoburners for anything regarding
  3968. ProTracker anymore since they have stopped developing it. I am therefore
  3969. collecting all reports until someone continues the ProTracker or I can
  3970. convince Cryptoburners to give me the source.
  3971.  
  3972. E-Mail: (Preferably)
  3973.     havardp@mail.stud.ingok.hitos.no
  3974.  
  3975. IRC: (Nice alternative)
  3976.     Nick: Howard or Howard_ or Howard__
  3977.     Channels: #amiga, #amigascne and #norge.
  3978.  
  3979. Snailmail: (When all else fails...)
  3980.  
  3981.                               - Page 56 -
  3982. 91.    Contacting the authors
  3983.  
  3984.     Håvard Pedersen
  3985.     Kvartsveien 175
  3986.     N-9022  KROKELVDALEN
  3987.     Norway
  3988.  
  3989. Phone: (Voice rate)
  3990.     +(47) 77 63 13 34 (Håvard)
  3991.  
  3992. 92.    For the technical minded
  3993.  
  3994. This chapter describes support files and other things needed to know
  3995. when writing applications that handles ProTracker files.
  3996.  
  3997.  
  3998.         File formats
  3999.  
  4000.         ProTracker song/module format
  4001.         ProTracker IFF song/module format
  4002.  
  4003.  
  4004.         Sources
  4005.  
  4006.         Using the ProTracker play-routine
  4007.         Using the ProPruner play-routine
  4008.         Using the SoundFX sound-replay engine
  4009.         Using the PTCalcTime playtime calculator
  4010.  
  4011.  
  4012.         Support software
  4013.  
  4014.         The TrackerTool command
  4015.         ProPacker v2.1 by Christian Estrup
  4016.         PPRStrip and PPRSampler
  4017.  
  4018.  
  4019.         Miscellaneous
  4020.  
  4021.         CIA tempo calculation
  4022.         DYN-Samples
  4023.  
  4024. 93.    ProTracker song&module format
  4025.  
  4026. PROTRACKER SONG/MODULE-FORMAT
  4027.  
  4028.  Offset Bytes   Description
  4029.  ------ -----   -----------
  4030.      0     20   Songname. Remember to put trailing null bytes at the
  4031.                 end... Please do also remember that a module may have
  4032.                 a 20-char name, which means that the string is not
  4033.                 zero-terminated.
  4034.  
  4035.     20     30   Sample information for sample 1 (See below)
  4036.  
  4037.     50     30   Sample information for sample 2
  4038.  
  4039.     80     30   Sample information for sample 3
  4040.      :      :
  4041.      V      V
  4042.    890     30   Sample information for sample 30
  4043.  
  4044.    920     30   Sample information for sample 31
  4045.  
  4046.    950      1   Songlength. Range is 1-128.
  4047.  
  4048.    951      1   Well... this little byte here is set to 127, so that
  4049.                 old trackers will search through all patterns when
  4050.                 loading. Noisetracker uses this byte for restart, but
  4051.  
  4052.                               - Page 57 -
  4053. 93.    ProTracker song&module format
  4054.  
  4055.                 we don't.
  4056.  
  4057.    952    128   Song positions 0-127. Each hold a number from 0-63 that
  4058.                 tells ProTracker what pattern to play at that position.
  4059.  
  4060.   1080      4   Identifier data.
  4061.  
  4062.                 Pro/Noise/Sound-Tracker                 "M.K."
  4063.                 100 pattern ProTracker v2.x             "M!K!"
  4064.                 StarTrekker 4-voice                     "FLT4"
  4065.                 StarTrekker 8-voice (not compatible!)   "FLT8"
  4066.                 FastTracker 4-voice (maybe compatible)  "CHN4"
  4067.                 FastTracker 6-voice (not compatible!)   "CHN6"
  4068.                 FastTracker 8-voice (not compatible!)   "CHN8"
  4069.                 ProRunner processed (not compatible!)   "SNT."
  4070.                 Wanton packer (not compatible!)         "WN"+0+crap
  4071.  
  4072.                 I've read somewhere that NoiseTracker modules has the
  4073.                 ID "M&K!", but this is not correct.
  4074.  
  4075.                 If the identifier is not there, the text has maybe been
  4076.                 removed to make the module harder to rip.
  4077.  
  4078.   1084    1024  Data for pattern 0. he number of patterns stored is
  4079.      :       :  equal to the highest patternnumber in the song position
  4080.      V       V  table (offset 952-1079).
  4081.    ???     ???
  4082.  
  4083.    ???     ???  If the file is a module, the sampledata follows right
  4084.                 after the patterndata. If not, this is the end. The
  4085.                 samples are located from 1 through 31. Use the
  4086.                 sampleinfo to find the start and end of each sample.
  4087.  
  4088.                 Each DYN sample is followed by a longword with length
  4089.                 of the DYN info, and then the DYN info itself. The
  4090.                 format of the DYN info is not publically available yet.
  4091.  
  4092.  
  4093.  
  4094. SAMPLE INFORMATION
  4095.  
  4096.  Offset Bytes   Description
  4097.  ------ -----   -----------
  4098.      0     22   Samplename. Pad with null bytes. See notes on
  4099.                 modulename.
  4100.  
  4101.     22      2   Samplelength. Stored as number of words. Multiply by
  4102.                 two to get real sample length in bytes.
  4103.  
  4104.     24      1   Lower four bits are the finetune value, stored as a
  4105.                 signed four bit number. The upper nibble is set to a 1
  4106.                 if this sample is a DYN sample.
  4107.                 Value:  Finetune:
  4108.                  0       0
  4109.                  1      +1
  4110.                  2      +2
  4111.                  3      +3
  4112.                  4      +4
  4113.                  5      +5
  4114.                  6      +6
  4115.                  7      +7
  4116.                  8      -8
  4117.                  9      -7
  4118.                  A      -6
  4119.                  B      -5
  4120.                  C      -4
  4121.                  D      -3
  4122.  
  4123.                               - Page 58 -
  4124. 93.    ProTracker song&module format
  4125.  
  4126.                  E      -2
  4127.                  F      -1
  4128.  
  4129.     25      1   Volume. Range is $00-$40, or 0-64 decimal.
  4130.  
  4131.  
  4132.     26      2   Repeat point. Stored as number of words offset from
  4133.                 start of sample. Multiply by two to get offset in
  4134.                 bytes.
  4135.  
  4136.     28      2   Repeat length. Stored as number of words in loop.
  4137.                 Multiply by two to get replen in bytes.
  4138.  
  4139.  
  4140.  
  4141. PATTERN FORMAT
  4142.  
  4143. Each note is stored as 4 bytes, and all four notes at each position in
  4144. the pattern are stored after each other.
  4145.  
  4146.     00 -  chan1  chan2  chan3  chan4
  4147.     01 -  chan1  chan2  chan3  chan4
  4148.     02 -  chan1  chan2  chan3  chan4
  4149.     etc.
  4150.  
  4151. Info for each note:
  4152.  
  4153.  BIT#  31  30  29  28  27  26  25  24     23  22  21  20  19  18  17 16
  4154.  USE   S7  S6  S5  S4  P11 P10 P9  P8     P7  P6  P5  P4  P3  P2  P1 P0
  4155.  
  4156.  BIT#  15  14  13  12  11  10  09  08     07  06  05  04  03  02  01 00
  4157.  USE   S3  S2  S1  S0  E11 E10 E9  E8     E7  E6  E5  E4  E3  E2  E1 E0
  4158.  
  4159.     S7-S0  - Samplenumber.
  4160.     P11-P0 - Period of note.
  4161.     E11-E0 - Effect command.
  4162.  
  4163. Periodtable for Tuning 0, Normal
  4164.     C-1 to B-1 : 856,808,762,720,678,640,604,570,538,508,480,453
  4165.     C-2 to B-2 : 428,404,381,360,339,320,302,285,269,254,240,226
  4166.     C-3 to B-3 : 214,202,190,180,170,160,151,143,135,127,120,113
  4167.  
  4168. To determine what note to show, scan through the table until you find
  4169. the same period as the one stored in byte 1-2. Use the index to look up
  4170. in a notenames table. These periods are really for NTSC timing, but is
  4171. used for both PAL/NTSC.
  4172.  
  4173.  
  4174.  
  4175. This is the data stored in a normal module/song. A packed song starts
  4176. with the four letters "PACK", and then comes the packed data.
  4177.  
  4178. 94.    ProTracker IFF song&modules
  4179.  
  4180. Introduction
  4181.  
  4182. The text below was intended to be the documentation on the fileformat
  4183. used in ProTracker. However, we decided to wait with the actual
  4184. implementation of the format until having released a couple of versions,
  4185. because we'd like to hear some comments, suggestions etc. upon it first.
  4186. So read it lightly, and feel free to post your opinion to one of the
  4187. authors. Note that since this is only a suggestion, don't start
  4188. programming a revolutionary new piece of code based on this info yet; we
  4189. may change the format :)... Here we go...
  4190.  
  4191. Fields marked "*Reserved*" are reserved for future use and are
  4192. guaranteed to cause hangup if messed with.
  4193.  
  4194.                               - Page 59 -
  4195. 94.    ProTracker IFF song&modules
  4196.  
  4197.  
  4198.  
  4199. General
  4200.  
  4201. With this release of Protracker we have decided to change the
  4202. filestructure of the musicfiles produced with the program. We felt the
  4203. old format was too obsolete, messy and out of date for us to use any
  4204. further. So we invented this new format. The format is based upon
  4205. Interchanged File Format (IFF) chunks, originally developed by
  4206. Electronic Arts, but now in widely use on the Amiga. The format allows
  4207. considerable flexibility and does not suffer too severly from changes
  4208. and updates, and is therefore perfect for our use.
  4209.  
  4210.  
  4211. The Format
  4212.  
  4213. We will in this section introduce and describe each chunk type appearing
  4214. in a Protracker music file. Look in the next section for the sequencial
  4215. description.
  4216.  
  4217. ** Contents of Chunk "VERS":
  4218.  
  4219.   OFFSET  Length  Contents  Meaning
  4220.   --------------------------------------------------
  4221.    0       4      "VERS"    Chunk identifier.
  4222.    4       4      ????????  Chunk length (in bytes).
  4223.    8       2      ????????  Version number (word).
  4224.   10       6      "PT3.00"  Version ID string.
  4225.   --------------------------------------------------
  4226.  
  4227. This chunk is used by Protracker to identify the producer of the module,
  4228. and if necessary perform upgrade-conversion if the file was made with a
  4229. pre- vious version of Protracker. There can be at maximum one "VERS"
  4230. chunk in a Protracker music file. This chunk is not critical; it may be
  4231. obmitted, but be aware of the possible incompatibility problems that may
  4232. arise if it's left out.
  4233.  
  4234. ** Contents of Chunk "INFO":
  4235.  
  4236.   OFFSET  Length  Contents  Meaning
  4237.   -------------------------------------------------------
  4238.    0       4      "INFO"    Chunk identifier.
  4239.    4       4      ????????  Chunk length (in bytes).
  4240.    8      32      [..??..]  Song name (string).
  4241.   40       2      ????????  Number of instruments (word).
  4242.   42       2      ????????  Number of positions (word).
  4243.   44       2      ????????  Number of patterns (word).
  4244.   46       2      ????????  Overall volume factor (word).
  4245.   48       2      0006h     Default speed (#VB) (word).
  4246.   50       2      ????????  Packed field. See below.
  4247.   -------------------------------------------------------
  4248.  
  4249. Protracker uses this chunk to set different internal variables, and to
  4250. store vital information used in replay and processing of the file. The
  4251. song name is a maximum 32 Chars long ASCII string. It need not be
  4252. NULL-terminated. Number of instruments indicates the number of
  4253. instruments used in the song, it may range from 0 to 65535. At present
  4254. version number, however, there may be maximum 255 instruments in one
  4255. song. Number of positions reflects the actual length of the song, that
  4256. is; how many patterns that will be played during a complete cycle. This
  4257. number may vary from 0 to 65535. Number of patterns, on the other side,
  4258. reflects how many _different_ patterns that will be played during the
  4259. song. This number is used to calculate the total length (in bytes) of
  4260. the song. The Overall Volume factor is used to compute the final volume
  4261. of all channels after the individual channel-volumes have been figured
  4262. out. In this way it is easy to control the loudness of the music from
  4263. the program/ song itself. Default speed is the number of VBlank frames
  4264.  
  4265.                               - Page 60 -
  4266. 94.    ProTracker IFF song&modules
  4267.  
  4268. between each pattern position change, and is as default set to 0006h.
  4269. The packed field consists of these bits (right to left order):
  4270.  
  4271.   Bit Meaning         0                      1                      Def
  4272.   ---------------------------------------------------------------------
  4273.    0  Filter flag.    Filter off.            Filter on.               0
  4274.    1  Timing method.  VBlank.                CIA timing (BPM).        0
  4275.    2  File type.      Module.                Song (no instruments).   0
  4276.    3  Packstatus.     Packed patterns.       Raw patterns.            1
  4277.    4  Length flag.    Equal pattern length.  Variable pattern length. 0
  4278.    5  Voices flag.    4 voices.              8 voices.                0
  4279.    6  Sample res.     8 bit.                 16 bit.                  0
  4280.    7  *Reserved*                                                      x
  4281.    8  *Reserved*                                                      x
  4282.    9  *Reserved*                                                      x
  4283.   10  *Reserved*                                                      x
  4284.   11  *Reserved*                                                      x
  4285.   12  *Reserved*                                                      x
  4286.   13  *Reserved*                                                      x
  4287.   14  *Reserved*                                                      x
  4288.   15  *Reserved*                                                      x
  4289.   ---------------------------------------------------------------------
  4290.  
  4291. There can be at most one "INFO" chunk in a Protracker musicfile. This
  4292. chunk is vital; it _must_ be present for the replay routine to function
  4293. properly.
  4294.  
  4295. ** Contents of Chunk "INST":
  4296.  
  4297.   OFFSET  Length  Contents  Meaning
  4298.   ----------------------------------------------------------
  4299.    0       4      "INST"    Chunk identifier.
  4300.    4       4      ????????  Chunk length (in bytes).
  4301.    8      32      [..??..]  Instrument name (string).
  4302.   40       2      ????????  Length of instrument (word).
  4303.   42       2      ????????  Instrument loop start (word).
  4304.   44       2      ????????  Instrument loop length (word).
  4305.   46       2      ????????  Instrument volume (word).
  4306.   48       2      ????????  Instrument finetuning (integer).
  4307.   ----------------------------------------------------------
  4308.  
  4309. The "INST" chunk is used to store information about an instruments
  4310. properties, such as length and volume. The instrument name is a maximum
  4311. 32 Chars long ASCII string. It need not be NULL-terminated. The Length
  4312. field describes the length of the instrument (in words) and thus ranges
  4313. from 0 to 128Kb (65535 words). Instrument Loop Start sets the offset
  4314. from which to start playing after the first replay. This value may vary
  4315. from 0 to the instrument length. Instrument Loop End sets the length of
  4316. the loop to play after the first replay, relative to the loop start
  4317. value. It may thus vary from 0 to [Ins_len-Loop_start]. Instrument
  4318. volume indicates which volume to use in the replay of the sample, if the
  4319. song doesn't say differently. This value varies between 0 and 40h.
  4320. Instrument finetuning sets the sample-rate correction difference and
  4321. varies from -7 to 7 (0fff9 to 0007h).
  4322.  
  4323. There may be any number of "INST" chunks in a Protracker music file,
  4324. limited to the number of instruments actually used in the song. This
  4325. chunk is not vital; it may be left out if the song-only bit of the
  4326. control word in the "INFO" chunk is set. Otherwise, it should result in
  4327. an error.
  4328.  
  4329. ** Contents of Chunk "PPOS":
  4330.  
  4331.   OFFSET  Length  Contents  Meaning
  4332.   --------------------------------------------------
  4333.    0        4     "PPOS"    Chunk identifier.
  4334.    4        4     0ffh      Chunk length (in bytes).
  4335.  
  4336.                               - Page 61 -
  4337. 94.    ProTracker IFF song&modules
  4338.  
  4339.    8      256     [..??..]  Pattern position table.
  4340.   --------------------------------------------------
  4341.  
  4342. This chunk contains the table defining which pattern to play in a given
  4343. song- position. Each entry in the table is a byte indicating which out
  4344. of 256 possible patterns to play. There may be at maximum one "PPOS"
  4345. chunk in a Protracker musicfile. This chunk is vital; it _must_ be
  4346. present to play the song.
  4347.  
  4348. ** Contents of Chunk "PTRN":
  4349.  
  4350.   OFFSET  Length  Contents  Meaning
  4351.   --------------------------------------------------
  4352.    0       4      "PTRN"    Chunk identifier.
  4353.    4       4      ????????  Chunk length (in bytes).
  4354.    8      32      [..??..]  Pattern name.
  4355.   40       ?      [..??..]  Pattern data.
  4356.   --------------------------------------------------
  4357.  
  4358. This chunk is used in a module of variable pattern length. The chunk
  4359. must thus appear as many times as there are patterns in the song. The
  4360. chunk length divided by 8 ( >>3 ) will show the pattern length (default
  4361. 64). Pattern name is a 32 byte long ASCII string, describing the
  4362. pattern, eg. "Intro part 3". It need not be NULL-terminated. This chunk
  4363. is critical; it must be present in the file, or it will be regarded
  4364. invalid. NOTE: This chunk is not in use in the present version (3.00B),
  4365. and will be ignored if found.
  4366.  
  4367. ** Contents of Chunk "SMPL":
  4368.  
  4369.   OFFSET  Length  Contents  Meaning
  4370.   ----------------------------------------------------
  4371.    0       4      "SMPL"    Chunk identifier.
  4372.    4       4      ????????  Chunk length. (In bytes!)
  4373.    8       ?      [..??..]  Raw sample data.
  4374.   ----------------------------------------------------
  4375.  
  4376. The "SMPL" chunk contains the raw sample data of an instrument. This
  4377. chunk is not critical; if the song-only bit of the "INFO" chunk is set,
  4378. it may be obmitted. If, however, the file is a module, then the number
  4379. of "SMPL" chunks in the file must be equal to or greater than the number
  4380. of instruments used in the song. If not, the file will be regarded
  4381. incomplete.
  4382.  
  4383. ** Contents of Chunk "CMNT":
  4384.  
  4385.   OFFSET  Length  Contents  Meaning
  4386.   --------------------------------------------------
  4387.    0       4      "CMNT"    Chunk identifier.
  4388.    4       4      ????????  Chunk length (in bytes).
  4389.    8       ?      [..??..]  Raw ASCII text.
  4390.   --------------------------------------------------
  4391.  
  4392. The "CMNT" chunk is used for a signature, comments, greetings, date of
  4393. completion or whatever information the composer wishes to include with
  4394. his or hers creation. This chunks is not critical; it may be left out
  4395. and will typically be ignored by most applications.
  4396.  
  4397. These are the chunks that may appear in a Protracker musicfile. If other
  4398. chunks are encountered, they will be ignored. Any program dealing with
  4399. this fileformat should perform tests to determine the validity of the
  4400. file in consideration. Using the Protracker.library will guarantee
  4401. correct handling of musicfiles, and we strongly encourage the use of
  4402. this runtime shared library instead of hacking away on your own. Look
  4403. elsewhere on this disk for the library documentation, the library can be
  4404. found in the "LIBS/" directory.
  4405.  
  4406.  
  4407.                               - Page 62 -
  4408. 94.    ProTracker IFF song&modules
  4409.  
  4410. The sequential format ---------------------
  4411.  
  4412. In this section we will describe how the various chunks are expected to
  4413. be located within the file. These rules _must_ be followed or it will
  4414. wreak havoc when tried manipulated with inside Protracker. Here comes
  4415. the header in table form:
  4416.  
  4417.   OFFSET  Length  Contents  Meaning
  4418.   -----------------------------------------------------
  4419.     0      4      "FORM"    Indicate start of IFF file.
  4420.     4      4      ????????  File length.
  4421.     8      4      "MODL"    IFF type identifier.
  4422.   -----------------------------------------------------
  4423.  
  4424. This header must be found in the start of the file, or it will be
  4425. rejected as not being a Protracker musicfile. From offset 12 in the
  4426. file, things may vary somewhat. The only rules are these: After a "INST"
  4427. chunk a "SMPL" or a new "INST" chunk _must_ follow. This "SMPL" chunk
  4428. will be regarded as the sample data of the instrument(s) preceding it.
  4429. If after a "INST" chunk another "INST" chunk follows, and the
  4430. module-flag in the "INFO" chunk is set, then all "INST" chunks following
  4431. each other will share the same sampledata found in the first "SMPL"
  4432. chunk after them. Also, all "INST" and "SMPL" chunks must be found in
  4433. sequence. That is, when a "INST" chunk is found for the first time in a
  4434. file, all other "INST" and "SMPL" chunks must follow. If this is not so,
  4435. an error message should be given, and processing terminated. Note that
  4436. in a song-only file, no "SMPL" chunks should be included. If any "SMPL"
  4437. chunks are encountered in such a file, they should be ignored and a
  4438. warning given. All other chunks used in a musicfile may be located
  4439. anywhere in the file, usually in the beginning of it, but no assumptions
  4440. of their locations should be taken. Note that all used chunks _must_ be
  4441. found _before_ the "BODY" chunk, which is the last chunk to be found in
  4442. the file. Searching for chunks should stop when encountering a "BODY"
  4443. chunk. The "BODY" chunk is constructed like this:
  4444.  
  4445.   OFFSET  Length  Contents  Meaning
  4446.   --------------------------------------------------
  4447.     0      4      "BODY"    Chunk identifier.
  4448.     4      4      ????????  Chunk length (in bytes).
  4449.     8      ?      [..??..]  Raw pattern data.
  4450.   --------------------------------------------------
  4451.  
  4452.  
  4453. Chunk summary
  4454.  
  4455. Now follows a list of the chunks that have meaning in a Protracker
  4456. musicfile:
  4457.  
  4458.  Chunk Function                                            Critical?
  4459.  -------------------------------------------------------------------
  4460.  VERS  Contains information about the producer of the file.       No
  4461.  INFO  Contains vital information and standard settings.         Yes
  4462.  INST  Information about instruments: length, volume etc.        Yes
  4463.  SMPL  Raw sample data associated with one or more instruments.   No
  4464.  PPOS  Position table. Information about patternsequence.        Yes
  4465.  CMNT  Comments, greetings etc. in ASCII code.                    No
  4466.  PTRN  Pattern data for modules with varying patternlengths.     Yes
  4467.  BODY  Pattern data for modules with equal patternlengths (def). Yes
  4468.  -------------------------------------------------------------------
  4469.  
  4470. 95.    Using the PT playroutine
  4471.  
  4472. Normal usage
  4473.  
  4474. The replay relies on you not turning on the audio DMA, as this is done
  4475. when needed.
  4476.  
  4477.  
  4478.                               - Page 63 -
  4479. 95.    Using the PT playroutine
  4480.  
  4481. In order to get the replay working properly it needs to initialize
  4482. itself. To make this happen, call PT_Init with a pointer to your module
  4483. in A0.
  4484.  
  4485. When this is done, everything is ready to go. Simply call PT_Music 50
  4486. times a second to achieve music. This call assumes exclusive access to
  4487. an OCS/ECS/AGA-compatible audio hardware located at $DFF000. It is safe
  4488. to call both PT_Init and PT_End if your PT_Music-calls are done in an
  4489. interrupt and your interrrupt is still enabled.
  4490.  
  4491. When you're finished, you may call PT_End to ensure that all pending
  4492. sound is removed.
  4493.  
  4494.  
  4495. Mastervolume/balance
  4496.  
  4497. In order for the mastervolume features of the replay to be enabled you
  4498. must insert "PT__MasterVol = 1" somewhere in your source before the
  4499. replay. You should, however, note that enabling the mastervolume
  4500. features heavily slows down the replay.
  4501.  
  4502. In order to adjust the mastervolume, you may call PT_SetMasterVol with
  4503. the volume (a word) for the left channel in D0 (range 0-64) and the
  4504. volume for the right channel in D1. The change takes place immediately.
  4505.  
  4506.  
  4507. Overstep
  4508.  
  4509. This is a strange word, which I generated myself when I couldn't find
  4510. another word to describe this feature. The idea behind overstep is that
  4511. the programmer should, in some way, be able to sense when the current
  4512. module is finished in order to be able to load in another module or
  4513. perform some other action based on this.
  4514.  
  4515. In order to activate overstep, insert "PT__OverStep = 1" in your
  4516. sourcecode. Overstep provides nearly no overhead.
  4517.  
  4518. The byte PT_OverStep will be written with a 1 if a position jump
  4519. occured, the module was halted, the end was reached or a fast forward
  4520. hit the end. The value -1 may occur in this byte if a rewind was done in
  4521. position 1.
  4522.  
  4523. Please note that the replay itself never clears the byte PT_OverStep, so
  4524. the programmer must do this himself when changes are sensed.
  4525.  
  4526.  
  4527. Winding
  4528.  
  4529. In order for the winding functions to be enabled, insert "PT__WindFuncs
  4530. = 1" in your source. You may now call the functions PT_Forward and
  4531. PT_Rewind to skip forward and backward one pattern at a time. The module
  4532. loops correctly both at beginning and end.
  4533.  
  4534. Please beware that if there are any position jump commands at the end of
  4535. the current pattern when you do a PT_Forward or a position jump command
  4536. just occured when doing a PT_Rewind, the positions may not be played in
  4537. a correct order. Working around this is way to much work, so settle with
  4538. it.
  4539.  
  4540.  
  4541. CIA timing
  4542.  
  4543. The replay does not do CIA timing itself, but has been extended with a
  4544. small support forl the user to implement this. To enable the CIA-mode of
  4545. the replay, insert "PT__CIA = 1" in your source.
  4546.  
  4547. When CIA is enabled, the replay assumes the user to supply a function
  4548.  
  4549.                               - Page 64 -
  4550. 95.    Using the PT playroutine
  4551.  
  4552. called PT_SetIntRate wich is to be called with the CIA tempo in D0 and
  4553. does not trash any registers. This function is called inside PT_Init and
  4554. each time the module attempts to change the CIA tempo.
  4555.  
  4556.  
  4557. 68020+ optimizations
  4558.  
  4559. To enable the 68020+ optimizations, insert "PT__68020 = 1" in your
  4560. source. The replay now uses a few 68020+ only instructions to gain some
  4561. speed. These optimizations aren't much for now, but may increase in the
  4562. future.
  4563.  
  4564.  
  4565. NoiseTracker compatibility
  4566.  
  4567. NoiseTracker is another tracker written by Mahoney and Kaktus which
  4568. writes modules almost identical to the ones written by ProTracker. As of
  4569. revision 2C, the ProTracker replay is capable of playing these modules
  4570. with the extra 'quirks' of the NoiseTracker module-format. The
  4571. NoiseTracker compatibility is on by default and may be disabled by
  4572. inserting "PT__NTComp = 0" in your source.
  4573.  
  4574. The NoiseTracker compatibility causes the replay to correctly play
  4575. NoiseTracker vibrato and utilises the repeat-feature of NoiseTracker.
  4576. This option uses nearly no (if any) extra CPU-time.
  4577.  
  4578.  
  4579. DMA delay (advanced users)
  4580.  
  4581. The well-known (and well-cursed) DMA wait is a small pause needed every
  4582. time the Amiga's audio hardware is supposed to change from one sample to
  4583. another. Commodore states that this delay should be equal to one
  4584. raster-line.
  4585.  
  4586. The ProTracker replay supports selecting this delay in order to save
  4587. some CPU-usage. The default delay is 80, which fits to Commodore's
  4588. recommendation. OctaMed by Teijo Kinnunen uses a delay equal to 64, and
  4589. I guess he haven't had any problems with it. You are not allowed to
  4590. specify a delay larger than 128.
  4591.  
  4592. The set the delay, insert the line "PT__DMADelay = n" in your source,
  4593. where n is the DMA delay you want. Please remember that this delay does
  4594. NOT need to be larger on faster machines, as it's timed using the
  4595. beam-position of the Amiga.
  4596.  
  4597. 96.    Using the PPR playroutine
  4598.  
  4599. BACKGROUND
  4600.  
  4601. The ProPruner playroutine is an attempt to make a replay that is
  4602. significantly faster than the clean ProTracker replay. The ProPruner
  4603. playroutine contains nearly all features that one can think of and is
  4604. pretty fast. In order to achieve the extra speed, it needs the modules
  4605. to be modified and saved in a special format. Currently, the ProPruner
  4606. replay need ProPacker v2.1 modules and does some internal changes to
  4607. these modules before playing them. The ProPacker v2.1 is made by
  4608. Christian Estrup and is spread without his permission. For documentation
  4609. on how to use the ProPacker, please read it's separate chapter. The
  4610. program TrackerTool will soon be able to output ProPruner modules
  4611. directly, so you won't need to use the ProPacker and the modules won't
  4612. need to be altered by the replay before playing.
  4613.  
  4614.  
  4615. BASIC USE OF THE PROPRUNER PLAYROUTINE
  4616.  
  4617. The first thing to do when using the ProPruner CIA shell or Level 6
  4618. timing is to fetch the vector base register and store in
  4619.  
  4620.                               - Page 65 -
  4621. 96.    Using the PPR playroutine
  4622.  
  4623. PPR_MainData+PPRM_VBR. The replay will then use it for compatibility on
  4624. higher processors.
  4625.  
  4626. In order to use the ProPruner playroutine, you have to initially call
  4627. PPR_Init with A0 pointing to your module and A1 pointing to your
  4628. samplefile if the use of a samplefile is enabled. When this is done, you
  4629. call PPR_Music each vertical blank to achieve music. CIA timing is
  4630. described separately later on. When you want to stop the music, call
  4631. PPR_End. It is perfectly safe to call PPR_Init and PPR_End while your
  4632. VBlank interrupt is still enabled.
  4633.  
  4634. The function PPR_Init may also be used for restarting the module and all
  4635. function trashes all registers except where else is stated. If
  4636. noteplayers are disabled, the module must be in chip memory. If you use
  4637. a separate samplefile, only the samplefile need to reside in chip
  4638. memory.
  4639.  
  4640. PPR_Init should not be called while a module is playing without first
  4641. calling PPR_End.
  4642.  
  4643.  
  4644. LEVEL 6 MODE
  4645.  
  4646. You may have ProPruner use the level 6 (CIA timers) interrupt for DMA
  4647. waiting in order to save cycles when playing modules. Keep in mind,
  4648. though, that neither the timers nor the interrupt vector is allocated
  4649. from the system, so this feature should only be used when all hardware
  4650. resources are available. When level 6 mode is in use, you cannot figure
  4651. out the rasterline usage by timing the PPR_Music call since some of the
  4652. actual work is done in an interrupt which occurs a while after the
  4653. PPR_Music call. Level 6 timing is enabled by setting PPR_Level6 to 1.
  4654.  
  4655.  
  4656. SEPARATE SAMPLEFILES
  4657.  
  4658. ProPruner supports separate samplefiles in order to save precious
  4659. chip-memory and delta-processing. Delta-processing is currently only
  4660. available when separate samplefiles are enabled. The samplefiles are
  4661. extracted from modules using the PPRStrip and the PPRSampler commands.
  4662. To enable the usage of separate samplefiles, set PPR_SampleFile to 1.
  4663.  
  4664.  
  4665. PREDOUBLING
  4666.  
  4667. This feature is hard to explain, but shortly it means that the module is
  4668. preprocessed during init in order to achieve slightly faster replay.
  4669. Since this processing may cause errors in some VERY large modules, it is
  4670. possible to disable it. Predoubling is on as default and may be turned
  4671. off by setting PPR_PreDouble to 0.
  4672.  
  4673.  
  4674. MASTERVOLUME CONTROLS
  4675.  
  4676. ProPruner's mastervolume system is a combination of balance and
  4677. mastervolume. The mastervolume provides a small speed overhead and
  4678. should therefore be left off if unused. If mastervolume is enabled, call
  4679. PPR_SetMasterVol with mastervolume for left side in D0 and mastervolume
  4680. for right side in D1. The range is 0-64. To enable mastervolume, set
  4681. PPR_MasterVol to 1.
  4682.  
  4683.  
  4684. DELTA-PROCESSED SAMPLEFILES
  4685.  
  4686. Delta-processing is currently only supported for separate samplefiles.
  4687. Delta-processing is an altering of the sample data in order to make them
  4688. easier to compress. When delta-processing is enabled, the ProPruner
  4689. playroutine will decode the sampledata back to their original form
  4690.  
  4691.                               - Page 66 -
  4692. 96.    Using the PPR playroutine
  4693.  
  4694. before starting the module. Delta-processing causes no changes to the
  4695. final sound. With delta-processing enabled, the ProPruner replay will
  4696. still handle module without delta-processing. To enable
  4697. delta-processing, set PPR_Delta to 1.
  4698.  
  4699.  
  4700. SELECTABLE FINETUNE
  4701.  
  4702. The finetune option consumes both rastertime and space in the replay, so
  4703. it is therefore advised to disable finetune if the replay is used to
  4704. replay module(s) without finetune. The packer will inform you of wether
  4705. the module uses finetune or not. To disable finetune, set PPR_Finetune
  4706. to 0.
  4707.  
  4708.  
  4709. CIA TIMING USING THE PROPRUNER PLAYROUTINE
  4710.  
  4711. The ProPruner playroutine does not support CIA timing directly, but
  4712. relies on the caller to provide the interrupt. If CIA timing is enabled,
  4713. the user must himself allocate necessary resources and set up an CIA
  4714. interrupt that calls PPR_Music. The playroutine will then call
  4715. PPR_SetBPM with beats per minute in D0 each time the CIA tempo is
  4716. supposed to change. The PPR_SetBPM function must be supplied by the
  4717. caller and may only destroy D0 and D1. Please do also note that the
  4718. Level6 function seldom works correctly when CIA mode is turned on. To
  4719. enable the CIA mode, set PPR_CIA to 1.
  4720.  
  4721.  
  4722. SELECTABLE 68020+ OPTIMIZATIONS
  4723.  
  4724. The ProPruner can be assembled using special 68020+ optimizations, which
  4725. may result in a slight rastertime usage decrease. The optimizations is
  4726. mostly noticeable when powerpattern is disabled, but is always (to some
  4727. extent) usable. To enable 68020+ optimizations, set PPR_68020 to 1.
  4728.  
  4729.  
  4730. PAUSE/CONTINUE FUNCTIONS
  4731.  
  4732. The ProPruner playroutine comes with selectable pause/continue
  4733. functions. When these are enabled, PPR_Pause is used to pause the module
  4734. and PPR_Continue is used for continuing the replay.
  4735.  
  4736.  
  4737. REWIND AND FAST FORWARD FUNCTION
  4738.  
  4739. Another feature of the ProPruner playroutine is the possibility to skip
  4740. one position forward/backward in the module. When this possibility is
  4741. enabled, PPR_Forward will skip one position forward in the module and
  4742. PPR_Rewind skips one position backwards. If the module is at the
  4743. beginning, ProPruner will automatically wrap to the end of the module.
  4744. These function may cause overstep events and may miss position jumps!
  4745.  
  4746.  
  4747. THE POWERPATTERN OPTIMIZATION
  4748.  
  4749. The heart of ProPruner is the powerpattern feature. This is a way of
  4750. storing the patterndata that differs slightly from both ProPacker (which
  4751. ProPruner is based on) and ProTracker. PowerPattern should pose any
  4752. problems but may be disabled by setting PPR_PowerPatt to 0.
  4753.  
  4754.  
  4755. NOTEPLAYERS - WHAT?
  4756.  
  4757. If the noteplayer feature is enabled, ProPruner itself won't bang
  4758. straight on the hardware to play the sound, but will use supplied
  4759. functions and macros for achieving sound. The macros are:
  4760.  
  4761.  
  4762.                               - Page 67 -
  4763. 96.    Using the PPR playroutine
  4764.  
  4765. PPRN_InitReg (Channel) - Is called to enable the noteplayer to set up A5
  4766. pointing to a data area needed by the other macros to perform correctly.
  4767. The argument "Channel" is in the range 0-3, thus making the selected
  4768. channel the "current" channel.
  4769.  
  4770. PPRN_KillSound - Has the sole purpose of killing the sound of all
  4771. channels. This macro may be called without having A5 pointing to
  4772. anything of significance.
  4773.  
  4774. PPRN_KillCh - Kill all sound on the current channel.
  4775.  
  4776. PPRN_TrigWave (Wavestart, Wavelen) - Causes the noteplayer to
  4777. immediately start playing the selected wave and loops back to the start
  4778. of the wave when the wave is through playing. Wavelen is given in number
  4779. of words.
  4780.  
  4781. PPRN_SetWave (Wavestart, Wavelen) - Does nearly the same as
  4782. PPRN_TrigWave except that the wave is not started until the current wave
  4783. has reached it's end.
  4784.  
  4785. PPRN_SetVolume (Volume) - Sets the volume (range 0-64) for the current
  4786. channel.
  4787.  
  4788. PPRN_SetRate (Rate) - Sets the samplerate for the current channel.
  4789.  
  4790. PPRN_SetMVolL (Volume) - Sets mastervolume for the left side. Range is
  4791. 0-64. A5 is not initialized.
  4792.  
  4793. PPRN_SetMVolR (Volume) - Sets mastervolume for the right side. Range is
  4794. 0-64. A5 is not initialized.
  4795.  
  4796. PPRN_Filter (State) - Attempts to change the status of the lo-pass
  4797. filter. The noteplayer doesn't need to support this action.
  4798.  
  4799. At the beginning if PPR_Music, the function PPRN_MakeSound is called.
  4800. This function may be used for mixing and trigging the actual sound
  4801. output. To enable noteplayer, set PPR_NotePlayer to 1.
  4802.  
  4803. The noteplayer feature has not been debugged at all, so don't be
  4804. surprised if it doesn't work. I would, however, be glad to hear about it
  4805. anyway.
  4806.  
  4807.  
  4808. SELECTABLE NUMBERS OF CHANNELS TO PLAY
  4809.  
  4810. The ProPruner playroutine is able to play less than 4 channels in order
  4811. to set the remaining channels free for soundeffects. This is especially
  4812. useful in conjunction with the SoundFX soundeffect replay engine.
  4813. Disabling channels effectively saves a huge amount of raster time and
  4814. should therefore be used even when the last channels isn't in use when
  4815. the module to replay has no notes on the last channels. To use this
  4816. feature, simply set PPR_Channels to the number of channels to play.
  4817.  
  4818.  
  4819. OBTAINING INFO FROM THE MODULE
  4820.  
  4821. The ProPruner playroutine supports a effectcommand not supported by
  4822. other replay, effectcommand 8 to send events to the replay. When the
  4823. module issues for instance effect command 847, the byte
  4824. PPR_MainData+PPRM_Msg will contain the hexadecimal number 47. The
  4825. programmer is free to read this value at any time and take actions upon
  4826. it.
  4827.  
  4828.  
  4829. OVERSTEP EVENTS
  4830.  
  4831. If the module has reached the end, the byte PPR_MainData+PPRM_RestFlag
  4832.  
  4833.                               - Page 68 -
  4834. 96.    Using the PPR playroutine
  4835.  
  4836. will be set to true (non-zero). The caller may then take proper actions,
  4837. such as loading another module.
  4838.  
  4839. 97.    Using SoundFX
  4840.  
  4841. WHAT IS SOUNDFX?
  4842.  
  4843. SoundFX is a sound-effect engine that enables playing of 2 samples
  4844. through one normal audio channel. The mixing is fairly fast and provides
  4845. minimal overhead. Both samples must have the same samplerate and cannot
  4846. be looped in current version. This is done to save CPU cycles when
  4847. mixing.
  4848.  
  4849.  
  4850. GENERAL USAGE
  4851.  
  4852. Call SFX_Init with the samplerate in D0. Minimum values are 123 for PAL
  4853. and 124 for NTSC. When using the fastmode (described below) only rates
  4854. of 226/228 or higher are supported.
  4855.  
  4856. Call SFX_SetVolume with volume (0-64) in D0 for adjusting the
  4857. mastervolume. This is not set to default values and should therefore be
  4858. done after the SFX_Init call.
  4859.  
  4860. Call SFX_StartSound with D0 stating which channel-partition to play on
  4861. (0 or 1 for now), A0 pointing to the sampledata (should be in fastmem if
  4862. possible) and A1 pointing to the end if the sampledata (samplepointer +
  4863. samplesize). The sampledata should be halved to avoid distortion. In
  4864. assembly this may be done by issuing a LSR.B #1 on all bytes.
  4865.  
  4866. Call SFX_End when the engine is not in use anymore. After this call,
  4867. SFX_Init must be called before further sound effects may be generated.
  4868.  
  4869. While the sampledata does not need to reside in chip, the SoundFX engine
  4870. itself has to because of some buffers.
  4871.  
  4872.  
  4873. SETTING THE BUFFERSIZE
  4874.  
  4875. The buffersize tells SoundFX how many bytes to mix at a time. Changes to
  4876. the sound (such as new samples) are only senced at the end of a buffer.
  4877. Smaller buffers yields better response-times but provides more CPU
  4878. overhead when starting the mixing while higher values does the opposite.
  4879. The default setting of 1024 bytes should be sufficient. To change the
  4880. buffersize set SFX__BuffSize to the number of bytes you wish the
  4881. buffersize to be. Please note that the buffersize must be an even
  4882. number.
  4883.  
  4884.  
  4885. THE FASTMODE
  4886.  
  4887. The fastmode provides a somewhat faster mixingscheme, but has worse
  4888. audio output than the normal mode. When fastmode is active you can only
  4889. use half the frequence of normal notes (rate 226/228 or higher) as
  4890. normal. This mixing mode may produce high-frequency tones which may both
  4891. distort the sound and destroy loudspeakers! To get rid of this quirk,
  4892. enable the audio filter. In fastmode, however, the sampledata does not
  4893. need to be halved. To enable fastmode, set SFX__FastMode to 1.
  4894.  
  4895.  
  4896. DIFFERENT OUTPUT MODES
  4897.  
  4898. The SoundFX engine at current supports two different output modes. To
  4899. select one, set SFX__Mode to the number of your mode.
  4900.  
  4901. (0) - Vertical blank. This mode is perhaps the most convenient one for
  4902. games that destroys the OS and does not wish to set up audio interrupt
  4903.  
  4904.                               - Page 69 -
  4905. 97.    Using SoundFX
  4906.  
  4907. themselves. The engine relies on the user to call SFX_VBLHandle each
  4908. vertical blank. All registers will be trashed. In this mode, the user
  4909. must choose both buffersize and the replay rate so that one buffer takes
  4910. exactly on frame to play. For help on how to calculate this, refer to
  4911. the Hardware Reference Manual from Addison Wesley. For the rate 224, the
  4912. samplebuffer should be set to 636 bytes.
  4913.  
  4914. (1) - OS Audio interrupts. (Default) This mode uses the operating system
  4915. to set up an audio interrupt which handles everything. The sound replay
  4916. is transparent to the caller and the buffersize may be freely chosen.
  4917.  
  4918. 98.    Using PTCalcTime
  4919.  
  4920. WHAT IS PTCALCTIME?
  4921.  
  4922. PTCalcTime is a source that calculates the playtime of ProTracker
  4923. modules.  This source operates internally with 1/25000ths of a second
  4924. and should  therefore be very accurate.
  4925.  
  4926.  
  4927. GENERAL USAGE
  4928.  
  4929. Call the function PTCalcTime with the registers set up as follows:
  4930.  
  4931. D0 - The songpos to start the module from. Normally, this should be 0.
  4932.  
  4933. D1 - 25000th of a second to pass between each interrupt. This should
  4934. normally be set to 25000/50.
  4935.  
  4936. D2 - Set to 1 if the timing is CIA based. Otherwise, set to 0.
  4937.  
  4938. A0 - Points to the ProTracker module.
  4939.  
  4940. A1 - Points to four longwords that are used for storing the playtime.
  4941. The  first longword will contain hours, the next minutes, then seconds
  4942. and  finally 1/100 seconds.
  4943.  
  4944. The function returns shortly, but might use up to 2-3 seconds on really
  4945. slow Amigas.
  4946.  
  4947. 99.    The TrackerTool command
  4948.  
  4949. What is TrackerTool?
  4950.  
  4951. TrackerTool is a small DOS-command designed for performing certain tasks
  4952. on modules, which is clearly beyond the scope of ProTracker itself. This
  4953. tasks mainly involve repairing and converting modules. (Current output
  4954. modes are only normal ProTracker modules, though.)
  4955.  
  4956.  
  4957. Why use TrackerTool?
  4958.  
  4959. If you've tried QuadraComposer, you may have found out that QC is not
  4960. able to identify Noise/Pro-Tracker modules properly if their size is
  4961. wrong. To make this problem even worse, some tools save 4 bytes extra on
  4962. modules because of a bug in earlier replay-routines. In order to fix
  4963. these modules you either load them one by one into ProTracker (if
  4964. they're not too damaged for ProTracker to recognize them!) and save them
  4965. back to disk or you could use TrackerTool.
  4966.  
  4967.  
  4968. How to use TrackerTool?
  4969.  
  4970. The template for TrackerTool is:
  4971.  
  4972. TrackerTool SOURCE=FROM/A,ALL/S,VERBOSE/S,UPDATE=UD/S,WRITE=TO
  4973.  
  4974.  
  4975.                               - Page 70 -
  4976. 99.    The TrackerTool command
  4977.  
  4978. SOURCE may be a file (ex: "mod.jugux"), a directory (ex: "modules/") or
  4979. a wildcard (ex: "mod.eat#?").
  4980.  
  4981. ALL specifies that subdirectories is entered recursively.
  4982.  
  4983. VERBOSE will cause TrackerTool to print a lot of useless information
  4984. about what it actually does. If TrackerTool shows strange behaviour,
  4985. enable VERBOSE in order to find out what actually goes wrong.
  4986.  
  4987. UPDATE specifies that the original module(s) are to be overwritten with
  4988. the repaired module(s).
  4989.  
  4990. WRITE specifies a path to write the repaired module(s) to.
  4991.  
  4992. For repairing all modules on you device XST-00: you would write:
  4993.  
  4994. TrackerTool XST-00: ALL UPDATE
  4995.  
  4996. Or repairing all modules in the current directory starting with an "a"
  4997. and write the repaired modules to RAM: you would write:
  4998.  
  4999. TrackerTool mod.a#? WRITE RAM:
  5000.  
  5001.  
  5002. Anything more to tell me?
  5003.  
  5004. Since the main reason for using TrackerTool (at current) is repairing
  5005. possibly damaged modules, TrackerTool does no attempt to identify the
  5006. specified file(s). Because of this, you must NEVER run TrackerTool on
  5007. any files that are not 31-instrument tracker modules. This includes text
  5008. files, IFF pictures and 15 INSTRUMENT TRACKER MODULES! If you attempt
  5009. this, your Amiga might crash with a horrible wail and if used in
  5010. conjunction with the UPDATE keyword, you will probably lose your files.
  5011.  
  5012. TrackerTool does, however, support up to 256 patterns, DYN samples and
  5013. 128 Kb long samples without problems.
  5014.  
  5015. 100.    ProPacker v2.1
  5016.  
  5017. READ FIRST!
  5018.  
  5019. ProPacker is needed to generate the modules for the ProPruner
  5020. playroutine. The ProPacker v2.1 is written by Christian Estrup and is
  5021. spread without his permission. What follows here are the original docs,
  5022. only slightly adjusted to fit the guidelines for this AmigaGuide
  5023. document. Some parts of the doc concerning the replay has been cut out.
  5024. Do also note that the ProPacker does not support being started from the
  5025. Workbench, but must be started from CLI/Shell.
  5026.  
  5027.  
  5028. PREFACE
  5029.  
  5030. Pro-Packer 2.1 is Freely Distributable. This means, that the program may
  5031. be freely distributed (!), as long as the replayer and this docfile are
  5032. included. NO money WHATSOEVER may be made from selling Pro-Packer 2.1.
  5033. Public Domain companies and their likes, who want to sell this program,
  5034. have to get a special, written permission from me. You will find my
  5035. address at the bottom of this doc-file.
  5036.  
  5037.  
  5038. INTRODUCTION
  5039.  
  5040. Pro-Packer 2.1 enables you to pack your ProTracker-modules (and
  5041. compatibles). It comes with a replayer, which is able to play the packed
  5042. modules a lot faster than the original PT-replay-routine.
  5043.  
  5044.  
  5045.  
  5046.                               - Page 71 -
  5047. 100.    ProPacker v2.1
  5048.  
  5049. THE PACKER
  5050.  
  5051. Using the packer is fairly easy. To load a module, just click in the
  5052. load gadget (surprise). You will then see the familiar (?) req.library
  5053. file-requester. (This means, of course, that you need req.library to run
  5054. the packer!)
  5055.  
  5056. When you've selected a module, it will automatically be packed. When
  5057. packing is finished, the packer will show you the length of the packed
  5058. module. The packer will also tell you, whether or not the module uses
  5059. finetune (see 'The Replayer' about this).
  5060.  
  5061. To save the packed module, just click in the save gadget (easy, isn't
  5062. it?), and you'll see the file-requester again. Select a filename, and
  5063. you're done...
  5064.  
  5065.  
  5066. COPYRIGHTS
  5067.  
  5068. req.library is (C) 1989 by Bruce Dawson and Colin Fox.
  5069.  
  5070. 101.    PPRStrip & PPRSampler
  5071.  
  5072. WHAT ARE THESE?
  5073.  
  5074. PPRStrip and PPRSampler are commands used for handling the generation of
  5075. separate samplefiles for use with the ProPruner replay routine. These
  5076. commands was originally thrown together for personal use, but should
  5077. nevertheless be bugfree as they have been thoroughly tested. Both these
  5078. commands needs OS 3.0+ to work.
  5079.  
  5080.  
  5081. PPRSTRIP
  5082.  
  5083. PPRStrip is used to strip the sampledata from ProPacker v2.1 modules.
  5084. The only argument supported is the filename, so the original module will
  5085. be overwritten.
  5086.  
  5087.  
  5088. PPRSAMPLER
  5089.  
  5090. PPRSampler is used for generating a samplefile from a ProTracker module.
  5091. The command supports three arguments:
  5092.  
  5093. SOURCEFILE - The complete path and filename of a ProTracker module. This
  5094. file will only be read and not changed in any way.
  5095.  
  5096. DESTINATIONFILE - The filename of the samplefile to generate.
  5097.  
  5098. DELTA - This is a keyword which, if present, causes PPRSampler to
  5099. delta-process the sampledata. Look in the documentation of the ProPruner
  5100. playroutine for information on delta-processing.
  5101.  
  5102. 102.    CIA tempo calculation
  5103.  
  5104. CIA TEMPO ISSUES
  5105.  
  5106.     Fcolor                        = 4.43361825 MHz
  5107.                                     (PAL color carrier frequency)
  5108.     CPU Clock   = Fcolor * 1.6    = 7.0937892  MHz
  5109.     CIA Clock   = Cpu Clock / 10  = 709.37892  kHz
  5110.     50 Hz Timer = CIA Clock / 50  = 14187.5784
  5111.     Tempo num.  = 50 Hz Timer*125 = 1773447
  5112.  
  5113. For NTSC: CPU Clock = 7.1590905 MHz --> Tempo num. = 1789773
  5114.  
  5115. To calculate tempo we use the formula: TimerValue = 1773447 / Tempo The
  5116.  
  5117.                               - Page 72 -
  5118. 102.    CIA tempo calculation
  5119.  
  5120. timer is only a word, so the available tempo range is 28-255 (++). Tempo
  5121. 125 will give a normal 50 Hz timer (VBlank).
  5122.  
  5123. A normal ProTracker VBlank song tempo can be calculated as follows: We
  5124. want to know the tempo in BPM (Beats Per Minute), or rather quarter-
  5125. notes per minute. Four notes makes up a quarternote. First find
  5126. interrupts per minute:
  5127.  
  5128.         60 seconds * 50 per second = 3000
  5129.  
  5130.     Divide by interrupts per quarter note = 4 notes * speed
  5131.     This gives: Tempo = 3000/(4*speed)
  5132.     simplified: Tempo = 750/speed
  5133.  
  5134. For a normal song in speed 6 this formula gives: 750/6 = 125 BPM
  5135.  
  5136. 103.    DYN Samples
  5137.  
  5138. DYN SAMPLES
  5139.  
  5140. Normal 8 bit samples are in most cases not "real" 8 bit samples, since
  5141. the waveform very rapidly moves towards the zero line, i.e., amplitude
  5142. zero. It then oscillates between values of, let's say, -5 to +5 or even
  5143. worse, between -2 and +2, very often even between 0 and 1. Only the very
  5144. first part of the sample, the attack, is in the nominal 8 bit range, the
  5145. rest is more or less in 1 to 4 bit resolution only! Considering the
  5146. dependance of "1 bit = 6 db", the amiga has a signal/noise ratio of 48
  5147. db. This is not very good, even low budget tape recorders have a better
  5148. S/N ratio. Of course, only 16 bit systems like CD players or DAT
  5149. recorders really reach 96 db (16 bit -> 16*6 => 96), but the amiga is
  5150. clearly at the botton of the list. So if we have an effective 1 to 3 bit
  5151. resolution, the S/N ratio is as bad as 6 to 20 db :-(
  5152.  
  5153. If you ever wondered why your sampler produces noise even when sampling
  5154. directly from a CD, it is not your samplers fault. It is the 8 bit
  5155. resolution, which is not really an 8bit resolution! Same is true if you
  5156. take very high quality 16 bit samples (yes, some privileged or stupidly
  5157. rich people have access to 16bit samples :-) and convert them to 8 bit
  5158. by using the higher 8 bit. The sound quality is very surprisingly not
  5159. much better (is it better?) than with a good 8bit sampler.
  5160.  
  5161. This fact is known, everybody tries to compensate it. Some people do it
  5162. by sampling far above 0 db level, which leads to a cutoff of the peaks
  5163. in the attack phase of the sample. Some kind of sounds allow this rather
  5164. rude technique, especially percussive sounds like bassdrum or snare,
  5165. also basses sometimes. Many people do this also on other sounds (Hi Jim!
  5166. ;-) to get "loud" samples. Clearly, this improves the sound quality at
  5167. the end of the samples. It is more or less a matter of trial and error
  5168. to get good samples this way, but as a workaround, I think this is a
  5169. valid method.
  5170.  
  5171. Ok, so far concerning the situation of today's amiga sampling. But now
  5172. to the DYN system (finally :)
  5173.  
  5174.  
  5175.  
  5176. HOW DYN WORKS
  5177.  
  5178. It utilizes 16 bit samples which are converted to special 8 bit samples.
  5179. The 16 bit sample is divided into "parts", which are normalized to 0 db.
  5180. 0 db means optimal recording condition, i.e. full usage of the 8 bit
  5181. range. The amplificiation factors of each part are stored. On replay,
  5182. the amiga hardware volume registers are set to compensate the
  5183. amplification of each part, which then reproduces the original signal.
  5184. The result is, that the sample data are always kept in the full 8 bit
  5185. range, which leads to significantly less noise, especially on fading
  5186. samples, samples with reverb, or any sample with a considerable dynamic
  5187.  
  5188.                               - Page 73 -
  5189. 103.    DYN Samples
  5190.  
  5191. volume change. Since the effective resultion changes dynamically between
  5192. 8 and 14(!) bit, I called the system DYN, for sake of a short,
  5193. describing name.
  5194.  
  5195.  
  5196.  
  5197. TECHNICAL DETAILS
  5198.  
  5199. The volume has to be altered while the sample is playing. It must be
  5200. changed very accuratly between the different parts. The only way to
  5201. realize this is by using the audio-interrupts. This was quite tricky,
  5202. since there is no (good) documentation available concerning the
  5203. programming of the audio-interrupts. However, to certain extent it works
  5204. now, so I am happy. :-)
  5205.  
  5206. The DYN samples themselves are stored as normal IFF 8bit samples, plus
  5207. an additional DYN chunk holding the information about the volumes each
  5208. part must be played with, and the length of each part. The structure of
  5209. a DYN chunk is described somewhere in the source. :-)
  5210.  
  5211.  
  5212.  
  5213. RESTRICTIONS OF THE DYN SYSTEM
  5214.  
  5215. Creation of DYN samples - First, it is difficult to create dyn samples.
  5216. One needs 16 bit samples to start with, not so easy for everyone of us.
  5217. The only one existing conversion program, called "DoDyn", is an ugly CLI
  5218. program which eats a lot of parameters, but has no GUI yet :-( One needs
  5219. several tries to get part lengths which do not produce clicking when the
  5220. part volumes are changed. A more intelligent DoDyn is needed!
  5221.  
  5222. Volume restrictions - Imagine a sample with a volume sequence like
  5223. 64-10-5-3-1-1-1 (very typical!). If you play this sample with volume 32,
  5224. you get either 32-5-2-1-0-0-0 (very bad) or you get 32-5-2-1-1-1-1
  5225. (better, but still not very good.). The volume ratios are distorted now,
  5226. the amplitude envelope will not be the one of the original 16 bit
  5227. sample. This is a result of the intrinsic volume changes, no way to
  5228. overcome that. It is a question of DoDyn parameters, for example, not to
  5229. allow amplifications which lead to volumes less than 4 when played with
  5230. volume 64. this would look like 64-10-5-4-4-4-4 then, played with volume
  5231. 32 giving 32-5-2-2-2-2 which is not so bad, but the max. resolution
  5232. imporovement would be to 12 bit only. Thats why I called the DYN system
  5233. also the "12 bit system".
  5234.  
  5235. Summarizing, playing dyn samples at low volumes can lead to distortion,
  5236. because the original different volumes will get more or less the same.
  5237.  
  5238. Handling - Dyn samples cannot be modified easily regarding length. It is
  5239. possible, but it needs enourmous efforts to keep track when cutting or
  5240. inserting to the sample, since the DYN part table must be adapted. There
  5241. is a limit for the length of parts! Each part must be long enough to
  5242. last over the DMA wait, for example. The DMA needs some time to copy the
  5243. data to the internal registers, so the interrupts must not come to
  5244. frequently. Therefore, handling of DYN samples is not very comfortable.
  5245.  
  5246. Timing - When a sample is played on 16 khz (around C-3), there are only
  5247. 320 sample points played in a 50 Hz (20 ms) frame, which is not much. It
  5248. means, that every scan line, another point is played. The hardware
  5249. always eats 2 points at once, so every 2 rasterlines, there is a change.
  5250. The Dyn interrupt itself lasts ca. one 4th of a rasterline. There can be
  5251. 4 interrupts which want to act at the same time, and it is clear that
  5252. they are not allowed to interrupt each other, so they have to wait until
  5253. the one before is ready. Since the soundroutine, running with CIA timer,
  5254. may not interrupt the audio-interrupts (which have a lower priority,
  5255. btw), the timing will be not *that* exact, but the largest delay between
  5256. each music routine frame will be about 1 rasterline only, therefore
  5257. negliable.
  5258.  
  5259.                               - Page 74 -
  5260. 103.    DYN Samples
  5261.  
  5262.  
  5263. For those who think, the interrupts could probably miss the part
  5264. changes, don't worry about that. The interrupts DO NOT come after a part
  5265. is played, but after the data are copied into the internal registers by
  5266. the audio hardware. The data of the next part are played by the hardware
  5267. automatically, so the correct sequence of the parts is granted. BUT, and
  5268. now comes the BUT, the VOLUME is set by the interrupts at the time the
  5269. interrupts come! What the interrupts do, is setting the volume into the
  5270. audio volume register, which is NOT buffered, but a "direct" register!
  5271. Because of the buffering of the DMA registers, the interrupts set the
  5272. volume of the previous part which was set into the hardware concerning
  5273. part start and part length. This is the crucial point. Now, an interrupt
  5274. really can come too late concerning the volume. It can be too late for
  5275. the time of 3 interrupts, because the first thing the interrupt does, is
  5276. setting the volume of the previous part, which is now played (assuming
  5277. the special case, all four interrupts want to come at the same time). If
  5278. the part volumes do big jumps, it can happen that some points of the new
  5279. part are still played with the old volume, which is definitely too loud.
  5280. There is no solution for this problem, but there is a workaround. It is
  5281. up to DoDyn not to allow big volume jumps, so the annoying clicking is
  5282. not that bad.
  5283.  
  5284. However, the chance to have interrupts waiting is almost negligable.
  5285. Normally, the partlengths of different samples differ quite much, and
  5286. you play them at different frequencies, so the interrupts should never
  5287. have to wait. You can force this problem to appear by playing the same
  5288. dyn sample at all 4 channels at the same frequency.
  5289.  
  5290.  
  5291.  
  5292.  
  5293.  
  5294.  
  5295.  
  5296.  
  5297.  
  5298.  
  5299.  
  5300.  
  5301.  
  5302.  
  5303.  
  5304.  
  5305.  
  5306.  
  5307.  
  5308.  
  5309.  
  5310.  
  5311.  
  5312.  
  5313.  
  5314.  
  5315.  
  5316.  
  5317.  
  5318.  
  5319.  
  5320.  
  5321.  
  5322.  
  5323.  
  5324.  
  5325.  
  5326.  
  5327.  
  5328.  
  5329.  
  5330.                               - Page 75 -
  5331. 103.    DYN Samples
  5332.  
  5333.  
  5334. 104.    INDEX of sections
  5335.  
  5336. Adjust tempo effect command ..................................  30. 22
  5337. Arpeggio effect command ......................................  27. 48
  5338. Chronicles and anecdotes .....................................  38. 18
  5339. CIA tempo calculation ........................................  71. 52
  5340. Contacting the authors .......................................  55. 48
  5341. Cut note miscellaneous effect command ........................  32. 54
  5342. Delay note miscellaneous effect command ......................  33.  1
  5343. Delay pattern miscellaneous effect command ...................  33. 16
  5344. Development and progress .....................................  38. 28
  5345. Disk operations ..............................................  17. 63
  5346. DYN Samples ..................................................  72. 15
  5347. Effect commands ..............................................  27. 17
  5348. Fine volumslide down miscellaneous effect command ............  32. 42
  5349. Fine volumslide up miscellaneous effect command ..............  32. 30
  5350. Fineslide down miscellaneous effect command ..................  30. 66
  5351. Fineslide up miscellaneous effect command ....................  30. 52
  5352. For the technical minded .....................................  56.  7
  5353. Frequently asked questions ...................................  54. 24
  5354. Gadgets ......................................................   2. 37
  5355. Glissando control miscellaneous effect command ...............  31. 12
  5356. How to create music using PT .................................  34. 59
  5357. How to start ProTracker ......................................   2. 30
  5358. Introduction .................................................   1. 40
  5359. Invert loop miscellaneous effect command .....................  33. 28
  5360. Keyboard .....................................................  24. 38
  5361. Keyboard percussion ..........................................  34. 28
  5362. Known bugs ...................................................  51. 65
  5363. Legal mush ...................................................   2.  3
  5364. Main screen - Chord editor ...................................  11.  0
  5365. Main screen - Edit gadgets ...................................  11. 43
  5366. Main screen - Edit options ...................................   7. 40
  5367. Main screen - Filter editor ..................................  11. 38
  5368. Main screen - Sample edit ....................................   8. 48
  5369. Main screen - Sample section .................................   6. 25
  5370. Main screen - Song section ...................................   4. 45
  5371. Main screen - Various ........................................   3.  3
  5372. Miscellaneous ................................................  38.  7
  5373. Nice to know .................................................  24. 12
  5374. Other tracker-clones .........................................  39. 65
  5375. Pattern break effect command .................................  30.  6
  5376. Pattern loop miscellaneous effect command ....................  31. 57
  5377. Patterns .....................................................  35. 44
  5378. Pointer colors ...............................................  24. 25
  5379. Position jump effect command .................................  29. 47
  5380. Position table ...............................................  36. 25
  5381. PPRStrip & PPRSampler ........................................  71. 20
  5382. ProPacker v2.1 ...............................................  70. 36
  5383. ProTracker documentation .....................................   1.  0
  5384. ProTracker IFF song&modules ..................................  58. 51
  5385. ProTracker song&module format ................................  56. 39
  5386. Requesters and I/O ...........................................  33. 43
  5387. Retrig note miscellaneous effect command .....................  32. 17
  5388. Sample offset effect command .................................  29. 23
  5389. Sampler - Main ...............................................  20. 30
  5390. Sampler - Volume requester ...................................  23. 35
  5391. Samples ......................................................  36. 54
  5392. Set filter miscellaneous effect command ......................  30. 37
  5393. Set finetune miscellaneous effect command ....................  31. 41
  5394. Set volume effect command ....................................  29. 61
  5395. Setup screen - Flags .........................................  15. 65
  5396. Setup screen - Miscellaneous .................................  13. 12
  5397. Slide down effect command ....................................  28. 11
  5398. Slide up effect command ......................................  27. 62
  5399. Standard paths ...............................................  34. 10
  5400.  
  5401.                               - Page 76 -
  5402. 104.    INDEX of sections
  5403.  
  5404. Thanks and acknowledgements ..................................  55. 41
  5405. The TrackerTool command ......................................  69. 39
  5406. Things we will implement .....................................  53. 43
  5407. Things we'll never implement .................................  53. 27
  5408. Toneportamento and volumeslide effect command ................  28. 51
  5409. Toneportamento effect command ................................  28. 24
  5410. Tremolo control miscellaneous effect command .................  32.  1
  5411. Tremolo effect command .......................................  29.  8
  5412. Using PTCalcTime .............................................  69. 10
  5413. Using SoundFX ................................................  68.  2
  5414. Using the PPR playroutine ....................................  64. 44
  5415. Using the PT playroutine .....................................  62. 59
  5416. V0.89 BETA ...................................................  42. 21
  5417. V1.0A ........................................................  42. 34
  5418. V1.0B ........................................................  42. 40
  5419. V1.0C ........................................................  43.  6
  5420. V1.1A ........................................................  43. 20
  5421. V1.1B ........................................................  45. 41
  5422. V1.2 .........................................................  46.  3
  5423. V1.2C ........................................................  46.  9
  5424. V1.3B ........................................................  46. 18
  5425. V1.8 .........................................................  46. 56
  5426. V2.0 .........................................................  46. 65
  5427. V2.1A ........................................................  47.  6
  5428. V2.2A ........................................................  48.  5
  5429. V2.3A ........................................................  49. 16
  5430. V3.00 BETA ...................................................  49. 40
  5431. V3.01 ........................................................  50. 46
  5432. V3.10 BETA ...................................................  51. 23
  5433. V3.14B .......................................................  51. 45
  5434. V3.15 ........................................................  51. 61
  5435. Version history ..............................................  41. 33
  5436. Vibrato and volumeslide effect command .......................  28. 63
  5437. Vibrato control miscellaneous effect command .................  31. 25
  5438. Vibrato effect command .......................................  28. 38
  5439. Volume slide effect command ..................................  29. 35
  5440. What is a module? ............................................  35.  3
  5441. What is DYN samples? .........................................  34. 45
  5442. What is ProTracker? ..........................................   1. 49
  5443.  
  5444. 105.    INDEX of keywords
  5445.  
  5446. 3 + A ........................................................  27. 30
  5447. 4 + A ........................................................  27. 31
  5448. accurate timing ..............................................  14. 50
  5449. authors ......................................................   2. 26
  5450. Break pattern ................................................  27. 30
  5451. C-Command ....................................................  36.  8
  5452. cheating .....................................................  34. 51
  5453. Chord editor .................................................   2. 50
  5454. Chronicles and anecdotes .....................................  38. 12
  5455. CIA tempo calculation ........................................  56. 37
  5456. command 1 ....................................................  28. 18
  5457. contact the authors ..........................................   1. 36
  5458. Contacting the authors .......................................  38. 17
  5459. Cut note .....................................................  27. 44
  5460. Delay note ...................................................  27. 45
  5461. Delay pattern ................................................  27. 46
  5462. Disk operation screen ........................................   6. 24
  5463. Disk operations ..............................................   2. 63
  5464. disk operations screen .......................................  17. 17
  5465. disk operations, .............................................  52. 26
  5466. disk-operations ..............................................  52. 37
  5467. disk-operations screen .......................................  39. 39
  5468. DYN sample ...................................................  57. 33
  5469. DYN samples ..................................................  35. 42
  5470. DYN sound ....................................................  39. 45
  5471.  
  5472.                               - Page 77 -
  5473. 105.    INDEX of keywords
  5474.  
  5475. DYN technical chapter ........................................   1. 33
  5476. DYN-sample ...................................................  53.  0
  5477. DYN-samples ..................................................  53.  3
  5478. E4x ..........................................................  28. 49
  5479. E7- ..........................................................  29. 21
  5480. Edit gadgets .................................................   2. 52
  5481. Edit options .................................................   2. 48
  5482. edit-gadgets .................................................  39. 39
  5483. Effect commands ..............................................  24. 20
  5484. effect-command ...............................................  36.  4
  5485. Effect-command 9 .............................................  52. 40
  5486. F command ....................................................   4. 35
  5487. Filter editor ................................................   2. 51
  5488. Fineslide pitch down .........................................  27. 42
  5489. Fineslide pitch up ...........................................  27. 41
  5490. Fineslide volume down ........................................  27. 43
  5491. Fineslide volume up ..........................................  27. 42
  5492. Flags ........................................................   2. 58
  5493. For the technical minded .....................................   1. 25
  5494. Frequently asked questions ...................................  38. 16
  5495. Frequently Asked Questions section ...........................  52.  4
  5496. Gadgets ......................................................   1. 21
  5497. Glissando control ............................................  27. 43
  5498. How to create music using ProTracker .........................   1. 23
  5499. How to start ProTracker ......................................   1. 48
  5500. inform us ....................................................   1. 39
  5501. Introduction .................................................   1. 20
  5502. Invert loop ..................................................  27. 47
  5503. Jump to position .............................................  27. 28
  5504. Keyboard percussion ..........................................  24. 23
  5505. Keyboard shortcuts ...........................................  24. 19
  5506. Known bugs ...................................................  38. 13
  5507. launch PT ....................................................  52. 59
  5508. Legal mush ...................................................   1. 47
  5509. Main .........................................................   3.  1
  5510. main screen ..................................................  13. 17
  5511. Miscellaneous ................................................   1. 24
  5512. Nice to know .................................................   1. 22
  5513. None/arpeggio ................................................  27. 25
  5514. normal portamento down .......................................  31.  7
  5515. normal portamento up .........................................  30. 59
  5516. normal volumeslide ...........................................  32. 37
  5517. Pattern loop .................................................  27. 46
  5518. patternbreak effect command ..................................  35. 55
  5519. Patterns .....................................................  35.  0
  5520. Pointer colors ...............................................  24. 18
  5521. Position-table ...............................................  35.  1
  5522. PPRStrip and PPRSampler ......................................  56. 32
  5523. PPRStrip and the PPRSampler ..................................  65. 38
  5524. ProPacker v2.1 ...............................................  64. 54
  5525. ProPacker v2.1 by Christian Estrup ...........................  56. 31
  5526. ProPruner ....................................................  71. 26
  5527. ProTracker development and progress ..........................  38. 25
  5528. ProTracker IFF song/module format ............................  56. 17
  5529. ProTracker song/module format ................................  56. 16
  5530. ProTracker version history ...................................  38. 27
  5531. ProTracker-relevant clones ...................................  38. 26
  5532. replen .......................................................  52. 43
  5533. Requesters and I/O ...........................................  24. 21
  5534. Retrig note ..................................................  27. 41
  5535. Sample edit ..................................................   2. 49
  5536. Sample edit operations .......................................  53.  6
  5537. sample editor ................................................  52. 48
  5538. Sample offset ................................................  27. 26
  5539. Sample section ...............................................   2. 47
  5540. sampler ......................................................   9. 52
  5541. Sampler screen ...............................................   7. 39
  5542.  
  5543.                               - Page 78 -
  5544. 105.    INDEX of keywords
  5545.  
  5546. Samples ......................................................  35.  2
  5547. select instrument ............................................  52.  9
  5548. send them ....................................................  41. 50
  5549. separate chapter .............................................  64. 57
  5550. Set finetune .................................................  27. 45
  5551. Set low-pass filter ..........................................  27. 40
  5552. Set speed ....................................................  27. 32
  5553. Set volume ...................................................  27. 29
  5554. Setup Screen .................................................   6.  3
  5555. setup-screen. ................................................  35. 64
  5556. Slide pitch down .............................................  27. 27
  5557. Slide pitch up ...............................................  27. 26
  5558. slide the volume .............................................  28. 59
  5559. Slide volume .................................................  27. 27
  5560. sliding the volume ...........................................  36. 19
  5561. Song section .................................................   2. 46
  5562. speed of the song ............................................  29. 45
  5563. Standard paths ...............................................  24. 22
  5564. starting PT ..................................................  52. 46
  5565. the three gadgets ............................................  36. 44
  5566. The TrackerTool command ......................................  56. 30
  5567. Things we will implement .....................................  38. 15
  5568. Things we'll never implement .................................  38. 14
  5569. tone-portamento ..............................................  31. 19
  5570. Toneportamento ...............................................  27. 28
  5571. TrackerTool ..................................................  64. 58
  5572. Tremolo ......................................................  27. 32
  5573. Tremolo control ..............................................  27. 47
  5574. tunetone setting .............................................  54. 52
  5575. Using the ProPruner play-routine .............................  56. 23
  5576. Using the ProTracker play-routine ............................  56. 22
  5577. Using the PTCalcTime playtime calculator .....................  56. 25
  5578. Using the SoundFX sound-replay engine ........................  56. 24
  5579. V0.89 BETA ...................................................  41. 65
  5580. V1.0A ........................................................  41. 66
  5581. V1.0B ........................................................  42.  0
  5582. V1.0C ........................................................  42.  1
  5583. V1.1A ........................................................  42.  2
  5584. V1.1B ........................................................  42.  3
  5585. v1.2 .........................................................  39. 14
  5586. V1.2C ........................................................  42.  5
  5587. V1.2D ........................................................  42.  6
  5588. V1.2E ........................................................  42.  7
  5589. V1.2F ........................................................  42.  8
  5590. V1.3A ........................................................  42.  9
  5591. v1.3A and v1.3B ..............................................  39. 16
  5592. V1.3B ........................................................  42. 10
  5593. V1.8 .........................................................  42. 11
  5594. v2.0 .........................................................  39. 14
  5595. v2.1A ........................................................  39. 26
  5596. V2.2A ........................................................  42. 14
  5597. v2.3a ........................................................  39. 27
  5598. v3.0 .........................................................  39. 28
  5599. V3.00 BETA ...................................................  42. 16
  5600. V3.01 ........................................................  42. 17
  5601. v3.10 ........................................................  39. 44
  5602. V3.10 BETA ...................................................  42. 18
  5603. V3.14B .......................................................  42. 19
  5604. V3.15 ........................................................  42. 20
  5605. Various ......................................................   2. 45
  5606. version history ..............................................   1. 35
  5607. Vibrato ......................................................  27. 29
  5608. Vibrato control ..............................................  27. 44
  5609. Volume requester .............................................   3.  2
  5610. What is a module? ............................................  34. 66
  5611. What is DYN-samples ..........................................  24. 24
  5612. What is ProTracker? ..........................................   1. 46
  5613.  
  5614.                               - Page 79 -
  5615. 105.    INDEX of keywords
  5616.  
  5617.